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PREFACE 


The Wang Professional C ompu ter Program Development Guide is designed to assist 
experxenced progt-ammers who use the Assembler or the compiled languages on the 
Wang PC. This guide is intended to be used with The Wane Professional 
g2. mputer Introductory Guide (700-8020A), The Wanq“Professional Comouter 

Ut ility Programs User Guide (700-8389), and with the manuals for the various 
programming languages. 


The guide provides you with two types of information: 

• Descriptions of the Wang PC's program development utilities 

• Technical information and specifications needed by programmers 

1 The Editor : Describes the Editor. This utility can create 

I ?J t T f ° r r pr0gramS in cora P lled languages and the Assembler. 

It can also create and modify text files such as memos, reports, and lists. 

Chapter 2 The Linker : Describes the Linker. This utility combines 
several separately-compiled object modules into one relocatable run file The 
Linker resolves references to symbols external to a particular module and it 

left ^resolved lPle llbrary fUeS for def initions of any external references 

Chapter 3 The Library Manager: Describes the Library Manager. This 
modlfiei ^ and deletes library files containing program 
modules that the Linker utility can link with other modules. The Library 
Manager provides a means to create either general libraries for a variety of 
programs or special libraries for specific programs. 

^ nt , ^ff tar . 4 „ The Debu< reer : Describes the Debugger. This utility provides 
controlled testing environment for binary files and executable object 
files. While using the Debugger, you can alter the contents of a file or the 

va^h”!^ °5 t w CPU , register and immediately reexecute a program to check the 
validity of the changes. 

g . ha Pter 5 System Archit ectu re, Operating System, and File Management : 
Presents the technical information about the Wang PC 8086 processor and the 
Microsoft Disk Operating System (DOS) that is particularly valuable for 
Assembly language and application programmers. 



Chapter 6 DOS Interrupts and Function Calls : Describes in detail how 
to call directly the DOS Interrupts and Function Calls for DOS versions prior 
to the 2.0 release and for DOS Versions 2.0 and greater. 

Chapter 7 BIOS Information : Describes the BIOS in detail including 
function calls, trappable events, the system configuration table, the screen 
information block pointer, the disk drive control block, shared device memory, 
disk I/O requests, and interrupt vector usage. 

Chapter 8 Hardware Interface : Presents information on screen 
manipulation, the keyboard, printer drivers and device drivers to allow 
Assembly language and application programs to directly interface with these 
system components. 

The appendices present the error messages, IBM Personal Computer to Wang 
Professional Computer code conversion information, and a glossary of 
abbreviations. 
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CHAPTER 1 
THE EDITOR 


1.1 INTRODUCTION 


The Wang PC Editor is a full screen editor that allows you to quickly and 
easily create and modify your source programs. This chapter presents a 
summary of each of the 32 PC Editor commands, as well as procedures for 
invoking the Editor. 

For a full description of the Editor and the commands, refer to The Wana 
Professional Computer Utility Programs User Guide . - a 


1.2 USING THE EDITOR 


This section summarizes how to invoke the Editor, how to exit from the Editor, 
and other features of the Editor. 


1.2.1 Invoking the Editor 


There are three ways to invoke the Editor: 

• From the Program Development menu — Place a diskette with system 
file PCEDIT.EXE in Drive A and select Editor. 

• From the DOS Command Processor — Enter the filename PCEDIT. 

• From the Main System menu — Select the Other option. Enter the 
filename PCEDIT on the File Spec line that appears on the menu. 


The Editor 



u use the DOS Command Processor or the Other option from the Main System 
you may specify the file you want to edit. For example, if you want to 
the SOURCE.ASM file, enter the following: 

PCEDIT source.asm 


Exiting from the Editor 


can exit from the Editor at any point in your editing session. Press 
"tt* + CANCEL (hold down the SHIFT key while pressing CANCEL) or CONTROL + 

' ' he Editor then prompts you to press EXEC if you want to save your changes 
t-.-ess N to delete the changes. 


3 Other Features 


tv. . Editor has an on-line summary of each of its 35 commands. Press HELP and 
ths commands appear at the top of the screen. Continue to press HELP until 
r; Vi command you want information about appears. To exit the on-line summary, 
c- .tinue to press HELP. 

D_: 3 ult Format 

The Editor uses the following default format: 

• 255-column width 

• Nine tab positions at every eighth position 

• No CONTROL + Z at end of file 

• Compressed format 

Modify CONFIG.EDT to change these values or specify different values for 
specific languages or both. The line format for CONFIG.EDT is as follows: 

<filename extension> KEYWORD = <value> [, ...] 


The keywords are TABS, WIDTH, COMPRESS, and CTRLZ. The values for TAB and 
WIDTH are decimal numbers. The values for COMPRESS and CTRLZ are either TRUE 
or FALSE. 

For example, you may want to specify the following defaults for assembly 
language source files: 

ASM TABS = 8,8,8,8 
ASM WIDTH = 120 
ASM COMPRESS = FALSE 
ASM CTRLZ = FALSE 
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. defaults you define for various extensions must be contained in 

|c>ne CONFIG.EDT file. If CONFIG.EDT contains more than one definition of a 
particular value for an extension, the Editor uses the last one. 

Line Numbers 


*“ tornatica “y numbers lines sequentially beginning at Line 1 and 
readjusts after insertions and deletions. 

Buffer Size 


The Editor maintains the file you are editing within a buffer. If your file 

PARTlS FlL: a co^nd e ( bl 1 fer *- Si r' a Separate file ‘ Th en, use the LOAD 

i^o Se S fiU t0 SeCtl ° n X * 3) t0 inS6rt 3 Sectlon of a " old file 

BAK Backup Files 

When you exit from the Editor, it keeps a backup copy of the original file 
with the same filename as the original file but with the extension .BAK 

to vnnr re ' P” alway8 ^ a co W of the file as it existed immediately prior 
to your roost recent changes. y * ozr 

The Window 



The window displays a maximum of 21 lines. The first four lines of the screen 
| re reserved for header, status, prompt, and tab lines. 

mode) JnH SP®! ° f ® ditin9 wifc hin the window exist: Center mode (the default 
i^ftlnrtfo 1 C ? rSOr m ° de (refer t0 Section 1-3. the CENTER command, for 

Center LSP th invoke the Center and Floating Cursor modes). In 

ca !!in^ r h cursor line is always in the center of the screen, thereby 

screen In this Ldp^h 6 * 11 * 1119 t0 be fixed aC the vertical <= a nter of the 
a new line . n" 86 " scrolls each time you position the cursor to 

above LP P T° d6 l0MS y ° U t0 866 the text lines that a PP ear directly 
e5?f%h.i 6 yOU are currentl y editing. Therefore, you can only 

edit the text in the screen's center. y 

In Floating Cursor mode, you can move the cursor to any line in the 

«« i» that lina. In Floating Curaor mLa. tha ac«an 

be^oi fh! ^r U d ry P *° sition the c ursor above the top display line or 
o the bottom display line. You can view a small portion of text without 

iith"! Tr ^. tOP Unes - Pleating Cursor mode is also helpful on systems 
with a low resolution video board because scrolling is slower with this Lard. 
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.3 EDITOR COMMANDS 


lost of the Editor commands require no parameters. For those that do require 
oarameters, prompts appear at the top of the screen. Edit the f^idswithin 
the prompts in the same manner that you edit a text line. Use TAB, BACK , 
and RETURN to move between fields. When you have entered the values you want, 
press EXEC. To abort a command, press CANCEL. 


Special Function (SF) key 15 is the recall key for parameter fields and 
t-ext lines. Press SF 15 after you invoke a command to update a parameter 
field with the value the field had the last time you invoked the command 
during that session. 


A table summarizing each of the Editor commands is presented below. 

Refer to The Wang Professional Computer Utility Pr ograms User Guide for a more 
complete description for each command. 


Cursor Movement 


Command 


Function 


Cursor East 

SHIFT + Cursor East 

Cursor West 

SHIFT + Cursor West 

Cursor North 

Cursor South 

TAB 

NEXT 

PREV 

SHIFT + NEXT 
SHIFT + PREV 
GO TO 


Move one character to the right. 

Move to last character in line. 

Move one character to the left. 

Move to first column in line. 

Move one line up. 

Move one line down. 

Move to the next tab stop. 

Move to next screen. 

Move to previous screen. 

Move to the last line of the file being edited. 

Move to the first line of the file being edited. 

Move to the line number specified within the prompt 
field. 
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Text Insertion 
and Replacement 

Command 

INSERT, 4 03 5 Id 

EXEC 

REPLC 

SHIFT + REPLACE 

Text Deletion 

Command 

BACK SPACE 

DELETE 

SHIFT + DELETE 

ERASE 

SHIFT + ERASE 

STOP 
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Function 


Enter Insert mode when not in Insert mode. 

Exit Insert mode when in Insert mode. 

Create a blank line and position the cursor at the 
beginning of the blank line. 

Replace selected occurrences of the string specified 
in the prompt field with the replacement string 
specified in the prompt field (press Y to replace it, 

N to go to next occurrence, or press CANCEL to 
terminate replacement). 

Replace each occurrence of string in the file, without 
prompts. 


Function 


Delete the character to the left of cursor, text not 
adjusted. 

Delete the character in the current cursor position, 
text adjusted. 

Delete the line at the current cursor position, text 
adjusted. 

Delete all characters from the current position to the 
end of the line, replace them with blanks, and 
maintain the cursor position at the point where you 
pressed ERASE. 


Delete all characters on the cursor line, replace them 
with blanks, and position the cursor at the beginning 
of the same line. 

Delete a block of text lines specified in the prompt 
fields. 
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Special Features 

Command 

CENTER, 

COPY 
DEC TAB 
MOVE 
PRINT 
SEARCH 

SHIFT + SEARCH 

Split Screen 

p A d e j +° 33 l<: 


TAB or T (uppercase 
or lowercase) 

Press Space bar at 
tab indicator, or 
enter a hyphen (-) 
over tab indicator 

FORMAT 


Function 


Enter Center mode when in Floating Cursor mode. 

Enter Floating Cursor mode when in Center mode. 

Copy a block of text specified in the prompt fields. 

Change the format line. 

Move a block of text specified in the prompt fields. 

Print block of text specified in the prompt fields. 

Search for case dependent occurrences of the string ' 
specified in the prompt field, press EXEC to find next 
occurrence. 

Search for case independent occurrences of string 
specified in prompt field, press EXEC to find next 
occurrence. 

Divide the screen into two windows for viewing and 
editing two portions of a file. 

Press PAGE to split the screen. Press PAGE again to 
return to an unsplit screen. Use the 
Subscript/Superscript key to move from one window to 
to the other. 

After pressing DEC TAB, Set tab at column of current 
cursor position. 

Erase tab position. 


Set column width specified in the prompt field. 

NOTE: This command does not reformat the text. If 

you shorten the line width, existing lines can be 
truncated, but are not lost, even if you save the file 
with the shortened line format on disk. Recover them 
by resetting the line width to the previous value. 

This command does not change the number of characters 
that appear on one line on the screen; it changes the 
number of characters within a logical line. 
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File Manipulation 
Command 

SHIFT + INDENT 

INDENT 

SHIFT + GOTO 


Function 


Load portions of a file specified within the prompt 
fields. F 

Load specified text file into memory from a disk. If 
you have made changes to the current text file, a 
prompt appears asking if the current text should be 
saved. Press EXEC to save the changes; press N to 
delete the changes. Press C or c to save the text in 
compressed format; press A or a to save text in 
uncompressed format. The default is compressed forma-. 

Write specified lines to specified file on disk. 

NOTE; If the specified file already exists, this 
command deletes the previous version. 
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CHAPTER 2 
THE LINKER 


2.1 INTRODUCTION 


The Linker program (LINK.EXE) is a relocatable linker designed to link 

XITfiX nn? dUC 6 l m °r dUl ! S ° f 0bjeCt COde ' The ob i ect code modules must be 
8 h 86 K f ly ‘ ThS Llnker uses a dictionary-indexed library search method 

which substantially reduces link time for sessions involving library 
searches. The Linker prompts you for all input. 1 


Overview of Linker Operation 


combines several separately compiled object modules into one 
relocatable load module or run file. All addresses in the run file are 
relative to one of the four 8086 segment registers. (Refer to Section 
b^uAd^ operating system can load the run file at any convenient 16-byt 


comoleJl^hi 9 ^?? thS ° bject "’odules their relative addresses, the Linker 
completes the following procedures: 

• Resolves references to symbols external to a particular module 

• Searches multiple library files for definitions of any external 
references left unresolved 

• Produces a list file that shows resolved external references and a 
error messages 

tha*- establishes the relative positions of the modules it links 

program uses as little memory as possible. When it exhausts 
available memory, the Linker creates a temporary disk file (VM.TMP) and acts 

more than^KB ' t0tal 8126 ° f th * Unked fileS ' however ' cannot be 

Figure 2-1 illustrates the Linker input and output operations. 
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Figure 2-1. Linker Input and Output 


2.1.2 Linker System Requirements 


The Linker utility requires a minimum of 50KB of memory, 40KB for code and 
data, 10KB for run space. 

The Linker does not allow you to swap disks during operation on a 
single-drive configuration. Therefore, a dual-drive system is the most 
practical configuration. However, systems with a single drive can use the 
Linker if output from the Linker is sent to the same physical disk from which 
the input is taken. 
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2.2 SEGMENTS, GROUPS, AND CLASSES 


This section describes how the Linker functions. It explains segments, 
groups, and classes, as well as how the Linker combines and arranges 
segments. 


2.2.1 Definitions 


Segment — A program module or a collection of modules each of which has 
the same segment name. A segment can be all or a part of a program and is the 
smallest unit the Linker manipulates. 

For assembly language, you assign modules to a segment by giving them 
the same segment name. For the compiled languages, the compiler assigns the 
segment name. 


The contents of a segment occupy a contiguous area of memory, up to 64KB 
long. The segment contents are addressed by a single segment register plus an 
offset. A segment can begin on a 16-byte boundary anywhere in 8086 memory. 

Group — A collection of segments that have different segment names but 
that are addressed from the same segment register. The segments within a 
group can occupy noncontiguous areas of memory. 

For assembly language, you assign the segments to a group by giving them 
the same group name. For the compiled languages, the compiler assigns the 
group name. 


Because all segments in the group are addressed by a single segment 
register plus an offset, the maximum size of the group is 64KB. The Linker 
ensures that the object modules of a group meet the 64KB constraint. 

Class Like a group, class is a collection of segments with different 
segment names. Unlike a group, the segments of a class occupy a contiguous 
area of memory. However, placing segments in the same class does not affect 
their addressing. 

The system names segments to a class at compile time or assembly time. 
For assembly language, you give the segments the same class name. For the 
compiled languages, the compiler assigns the class name. 

The naming of segments to a class controls the order and the relative 
placement of segments in memory. One class precedes another in memory if a 
segment of the first class precedes all segments of the second class in the 
input to the Linker. Thus, once the Linker accepts a segment from a class as 
input, it places all other segments of the same class contiguously in memory 
before placing segments of any other classes in memory. 
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The Linker loads the segments of a class in the order in which it 
encounters the segments in the object files. Classes can be loaded across 

64KB boundaries. ( 

M 


For example, assume class CODE contains segments A and D and class DATa 
contains segments B and C. If the first segment found by the Linker is A, the 
Linker places the segments belonging to class CODE m a contiguous area of 
memory, preceding the segments of class DATA. But if segments A and C belong 
to group G, their addresses have the same segment register, even though they 
occupy noncontiguous areas of memory. 


2.2.2 How the Linker Combines and Arranges Segments 


The Linker works with four "combine types," which you declare in the source 
module for the Assembler or compiler: private, public, stack, and common 
The memory combine type available in Microsoft's MACRO-86 is treated the same 
as the public combine type. The Linker does not automatically place memory 
combine type segments at the highes t addresses. 

The Linker combines segments for these combine types as follows: 


Private 



0 

0 


Private segments are loaded separately and remain 
separate. They can be physically contiguous, but not 
logically, even if the segments have the same name. 
Each private segment has its own base address. 


Public/Stack 



Public segments of the same name and class name are 
loaded contiguously. The offset is from beginning of 
the first segment loaded through last segment loaded. 
Only one base address exists for all public segments of 
the same name and class name. 


Stack and memory combine types are treated the same as 
public. However, the Stack Pointer is set to the first 
address of the first stack segment. (Public segments of 
the same segment name, but different class names, may or 
may not be loaded contiguously.) 
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Common 


Common segments of the same name and class name a-e 
loaded overlapping one another. That is, one base 

address exists for all common segments of the same 
name. 

Only one of the segments is in memory at any time 
the system loads another segment at the same address, 
the previous segment is overwritten. The length o* 
the common area is the length of the longest segment 
(The initial values of variables in a colon sejent'ma- 
be indeterminate.) b ^ ^ 

Be aware that the Linker displays the "Warning: Mo Stac* 
Segment message when it links an object file with no 

segment. H ° Wever ' the Llnker assign a default stack 

. .. Pla = ln 9 segments in a group in the Assembler provides offset 
of items from a single base address for all segment? in tit gr^p. 


DS: DGROUP- 


Any number of other 
segments can intervene 
between segments of a 

group. Thus, the _ 

offset of FOOH can be 
greater than the size 
of segments in group 
combined, but no larger 
than 64KB. 


-XXXXOH 


A 

B 

-FOOH- 

C 


0 


— relative offset 


An operand of DGROUP:FOOH 
returns the offset of FOOH 
from the beginning of the 
first segment of DGROUP 
(segment A here). 


The Linker loads segments 
segments belonging to the first 
segments of the next class name 
the classes. 


by declared class names. It loads all the 
class name encountered, then loads all the 
encountered, and so on until it has loaded all 


If an assembly language program contains: They are loaded as 


A SEGMENT 'FOO' 
B SEGMENT 'BAZ' 
C SEGMENT ‘BAZ’ 
D SEGMENT ♦ZOO’ 
E SEGMENT 'F00 f 


’FOO 

A 

E 

'BAZ* 

B 

C 

•ZOO' 

D 
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If you are writing assembly language programs, you can control the 
ordering of classes in memory by writing a dummy module and listing it first 
in response to the Linker's Object Modules prompt. The dummy module declares 
segments into classes in the order you want the classes loaded. For example: 


A 

SEGMENT’ 

’CODE’ 

A 

ENDS 


B 

SEGMENT 

’CONST* 

B 

ENDS 


C 

SEGMENT 

’DATA* 

C 

ENDS 


D 

SEGMENT 

STACK 

D 

ENDS 


E 

SEGMENT 

•MEMORY 

E 

ENDS 



Be sure to declare all classes you use in your program in this module. 

:£ you do not, you lose absolute control over the ordering of classes. 

Also if you want to load segments with the memory combine type as the 
last segments of your program, simply add MEMORY between SEGMENT and ’MEMORY* 
in the E segment line above. Note, however, that the Linker loads these 
segments last only because you impose this control on them, not because of any 
nherent capability in the Linker or Assembler operations. 


CAUTION: 

to not use this method with BASIC, COBOL, FORTRAN, or Pascal programs. Allow 
the compiler and the Linker to perform their tasks in the normal way. 


2.3 LINKER FILES 


The Linker works with one or more input files, produces two output files, can 
create a virtual memory file, and can be directed to search one to eight 
library files. For each file type, you can give a 3-part file specification. 
The format for the Linker file specifications is as follows: 

[<d:>]<filename>[.<ext>] 

<d:> 


<filename> 
.<ext> 


is the drive designation. The colon is always required 
as part of the drive designation. If you do not enter a 
drive designation, the default drive is used. 

is any legal file name 1- to 8-characters long. 

is a 1- to 3-character extension to the file name. The 
period is always required as part of the extension. 
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The three Linker file types are as follows: 

1. I n put files — The Linker appends the following default extension., 

to the input (object and library) file specifications: tensi ° ns 

.OBJ for object files 
.LIB for library files 

2. O u tput Files —The Linker appends the following default extensions 

to the output (run and list) files: extensions 

'Sp to 2ist^files <Y °“ Can " 0t ° VeCride the default.) 


3. 


VM.TMP File The Linker uses available memory for the link 
session If the linked files create an output file that exceeds 

VM TMP IfTh^L ^ 6 Lin T Creat6S 3 tem P° rar y and names it 

message: S ° reate VM '™ P ' displays the 

VM.TMP has been created 

Do not change diskette in drive, <d:> 

““'' redi «* ble - «» ^ht 


Unexpected end of file on VM.TMP 




CAUTION: 


2 - 4 RUNNING THE LINKER 


Two types of commands will 
commands to answer command 
optional Linker features. 


run the Linker: commands to invoke the Linker and 
prompts. In addition, six switches control 


The Linker 


Usually, you enter all the commands to the Linker on the keyboard. 
Alternatively, you can create a response file containing answers to the 
command prompts and switches. The Linker supports some special command 
characters to assist you while entering commands. 

You can invoke the Linker in one of the following four ways. 

Method 1 

1. Select the Program Development option from the Main System menu. 

2. Select the Linker option from the Program Development menu (Figure 
1 - 1 ) . 

3. The Linker displays four prompts, one at a time. Your answers to 
the prompts are commands to the Linker to perform specific tasks. 

Method 2 

1. Select the DOS Command Processor or Other option from the Main 
System menu. The DOS prompt or a file specification prompt appears. 

2. Enter the following command: 

LINK 

This response loads the Linker into memory. Then, the Linker 
returns four prompts, one at a time. 

Method 3 

1. Select the DOS Command Processor option from the Main System Menu. 
The DOS prompt or a file specification prompt appears. 

2. Enter the following command: 

LINK <object-list>,<runfile>,<listfile>,<lib-list>[-switch...] 

The entries following LINK are responses to the command prompts 
described in Section 2.5. 

<object list> is a list of object modules, separated by plus signs. 

<runfile> is the name of the executable output file. 

<listfile> is the name of the file to contain the listing. 

<lib-list> is a list of library modules you want to search. 

<-switch...> are optional switches, which you can place following 
any of the response entries (before any commas or after the 
<lib-list>, as shown). 
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You must use commas to separate the entry fields for the different 

■ 2 ?- £ for * 

LINK FUN+TEXT+TABLE+CARE-P-M,,FUNLIST.COBLIB.LIB 


2r^?:“£S the - p 

b asa— 1 *- - “cS; rs^ 


Method 4 


Create 


a response file. 


A response file consists of text lines, one for each prompt 

aDDMr SeS n mUSt a F P ! ar ln th ® same order 33 the command prompts 
PP . Use switches and command characters in the response file 

.... „„„ „ ^ „„ them tor r . spons . s ^ „ ter 0 „ p ™;* k ^ rd 

2. Select the DOS Command Processor or Other option from the Main 
System Menu. The DOS prompt appears. 

3. Enter the following command: 

LINK @<filespec> 

<filespec> is the name of a response file. A response file 
answers to the Linker prompts and can also conta ^switches Method 

4 permits you to conduct the link session without interne 
(direct) responses to Linker prompts. interactive 

ft™. t£“ S^.“::“ i s. 6 ssir2 1 pr r t * p r" ” ith «»"•*»■•« 

that does not have a response^waits'flr 6 after dls Playing a prompt 

you have entered a legal response, the LiSr ^onSnu 

s s Link " 


FUN TEXT TABLE CARE < RETURN> 
-PAUSE-MAP <RETURN> 

FUNLIST <RETURN> 

COBLIB.LIB <RETURN> 
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2.5 COMMAND PROMPTS 


To give commands to the Linker, 
prompts. Default responses are 
are presented in Table 2-1. 


enter responses to the four consecutive text 
shown in square brackets ([ ]). The prompts 


Table 2-1. Linker Command Prompts and Descriptions 


Prompt _ 

Object Modules [OBJ]: 


Run File [<Object-file>.EXE]: 


List File [<Run-f ile>.MAP]: 


Libraries [ ]: 


Des cription _ 

• Enter a list of object modules, 
separated by a space or plus 
sign. 

• No default file name. 

• Enter the file name for the 
file to receive the executable 
object code. 

• Enter the file name for the 
listing file. 

• The list file contains an entry 
for each segment in the input 
file. Each entry shows the 
offset in the run file. 

• Enter 1 to 8 library file 
names, separated by blank 
spaces or plus signs, for a 
library search. 

• Press RETURN for no library 
search. 

• The Linker searches the library 
files in the order listed to 
resolve external references. 

For multiply defined symbols, 
the search ceases when it finds 
the first instance. 
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2.6 COMMAND CHARACTERS 


The Linker provides three command characters to aid you in entering commands 
Refer to Table 2-2. 


Table 2-2. Linker Command Characters and Descriptions 


Command 

Description 

+ (the plus sign) 

• 

Separates entries and extends 
the current logical line 
following the Object Modules 
and Libraries prompts. 


• 

To enter multiple responses, 
enter plus sign/RETURN at the 
end of the physical line. 


• 

Enter module name/RETURN at 
the end of the last response 
line. 

; (the semicolon) 

• 

Selects default responses to 
the remaining prompts (press 
semicolon/RETURN). 


• 

To bypass prompts„ press 

RETURN. 

SHIFT + CANCEL (hold down 

• 

Aborts the link session. Use 

SHIFT while pressing CANCEL) 


if you enter an incorrect 
response. 


• 

If you have typed an error 
but not entered it, you can 
retype the characters for 
that line only. 
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2.7 SWITCHES 


At the end of each prompt line, you can enter one or more switches that 
control optional Linker functions. You can group switches at the end of any 
one of the prompt responses, or you can scatter them at the end of several 


responses. 


You must precede each switch with the switch character, a hyphen. 
Without a particular switch, the Linker does not perform the function defined 
for that switch. 


For all switches, you can use an abbreviation, from a single letter 
through the whole switch name. However, the abbreviation must be a sequential 
substring from the first letter through the last entered, with no gaps or 
transpositions. For example, for the —DSALLOCATE switch:: 

Legal Illegal 


-D 

-DS 

-DSA 

-DSALLOGA 


-DSL 

-DAL 

-DLC 

-DSALLOCT 


The switches are listed in Table 2-3. 


Table 2-3. Linker Switches and Descriptions 


Switch 

Description 

-DSALLOCATE 

• 

Directs the Linker to load all 
data at the high end of the Data 
Segment (DS). 


• 

Required for Pascal and FORTRAN 
programs. 

-HIGH 

• 

Causes the Linker to place the 
run file as high as possible in 
memory. 


• 

Do not use with Pascal or FORTRAN 
programs. 

-LINENUMBERS 

• 

Directs the Linker to include in 
the list file the line numbers 
and addresses of the source 
statements in the input modules. 
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Table 2-3. Linker Switches and Descriptions (continued) 


Switch 

Description 

-MAP 

• 

Directs the Linker to list all i 

public (global) symbols defined 
in the input modules, together 
with their definitions. 


• 

The Linker alphabetically lists 
the symbols, along with their 
values and segment:offset 
locations in the run file. The I 

symbols appear at the end of the 
list file. j 

-PAUSE 

• 

Causes the Linker to pause in the ! 
link session and waits for you to I 
press RETURN. 


• 

Do not swap the disk that 
receives the list file or the 
disk used for the VM.TMP file, if 
created. 

-STACK:<number> 

• 

Directs the Linker to allocate a 
stack of the specified size for 
the run file. 


• 

<number> represents any 
hexadecimal value from 200H to 

FFFFH bytes. 


• 

The Linker automatically 
calculates the required stack 
size, unless you specify it. 


• 

At least one object module must 
contain a stack allocation 
statement. 


The Linker 
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CHAPTER 3 

THE LIBRARY MANAGER 


3.1 INTRODUCTION 


The Library Manager (LIB.EXE) is a utility that creates, modifies, and deletes 
library files used with the Linker. This chapter explains the features and 
operation of the Library Manager. 


3.1.1 Features and Benefits 


The Library Manager creates files containing program modules that the Linker 
utility can link with other modules. (Refer to Chapter 2, The Linker.) Once 
it creates a library file, the Library Manager can add modules to it, delete 
modules from it, or create separate object files from library file modules. 

The distinction between an object file and a module (or object module) 
is that a module is part of a file. Therefore, while you must give a file a 
drive designation, at least by default, and can give it a file name extension, 
you can give neither of these to object modules. However, the drive 
designation and extension are used with the library file to which a module 
belongs. 


The Library Manager allows you to create general libraries for a variety 
of programs or special libraries for specific programs. For example, with the 
Library Manager you can create a general library for a language compiler. Or, 
you can create a special library that permits fast linking and possibly more 
efficient execution, for one program only. 

You can modify individual modules within a library by extracting the 
modules, making changes, and then adding the modules to the library again. 

You can replace an existing module with a different module or with a new 
version of an existing module. 
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3.1.2 Overview of Library Manager Operation 


The Library Manager performs two basic actions. First, it changes object 
files into modules and appends them to a library file. Second, it deletes 
modules from a library file. These two actions are the basis for the five 
Library Manager functions: 

• Create a library file 

• Append an object file as a module of a library 

• Delete a module 

• Make a separate object file by copying a module 

• Replace a module in the library file with a new module 

During each library session, the Library Manager first deletes or 
extracts modules, then appends new ones. This order of execution prevents 
cmfusion when a new version of a module replaces an old version in the 
library file. (The replace function is simply the delete-append functions in 
succession.) You can specify delete, append, or extract functions in any 
order. 


In a single operation, the Library Manager loads each module into 
iramory, checks it for consistency, and writes it back into the file. The 
consistency check determines whether or not the module’s syntactical form is 
correct and that its file name is unique. If you delete a module, the Library 
Manager loads that module, but does not write it back into the file. 

When the Library Manager writes back the next module to be retained, itm 
places that module at the end of the last module written. This procedure " 

effectively closes up the file space to keep the library file from growing 
larger than necessary. 

When the Library Manager has read through the whole library file, it 
appends any new modules to the end of the file. The Library Manager also 
creates an index, which the Linker utility uses to find modules and symbols in 
the library file. (The Library Manager may take up to 20 seconds to build an 
index.) Finally, the Library Manager produces a cross-reference listing of 
the PUBLIC symbols in the library, if requested. 

Figure 3-1 illustrates the various Library Manager operations. 
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Figure 3-1. Library Manager Operations (continued) 


3.1.3 Library Manager System Requirements 


The Library Manager requires 38KB of memory minimum, 28KB for code and 10KB 
for run space. 

You can use the Library Manager with a single-drive system only if you 
send output to the same physical disk from which the input was taken. None of 
the utility programs in this package allow time to swap disks during operation 
on a single-drive system. 
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3.2 RUNNING THE LIBRARY MANAGER 


Running the Library Manager requires two types of commands: commands to 
invoke the Library Manager and commands to answer command prompts. 

Usually, you enter all the commands on the keyboard. As an option, you 
can create a response file containing answers to the command prompts. The 
Library Manager supports special command characters for entering the 
commands. (Refer to Section 3.3.) 

You can invoke the Library Manager in one of the following four ways. 
Method 1 


1. Select the Program Development option from the Main System menu. 

2. Select the Library Manager option from the Program Development 
menu. The Library Manager then displays a series of four prompts, one 
at a time. 

Method 2 


1. Select the DOS Command Processor or Other option from the Main 
System Menu. The DOS prompt or a file specification prompt 
appears. 

2. Enter the following response to load the Library Manager into memory 
>LIB 


The Library Manager returns a series of four prompts that appear one 
at a time. 

The following example shows responses to prompts from Methods 1 and 2 : 

Library file:pascal 
Ope ration:-heap+heap; 

List file: 

These responses delete the old library module HEAP from the library 
file, and then adds a new file HEAP.OBJ as the last module in the library. 
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Method 3 

1. Select the DOS Command Processor or Other option from the Main 
System menu. The DOS prompt or a file specification prompt 
appears. 

2. Enter the following response: 

LIB <library><operations>,<listing> 

The entries following LIB are responses to the command prompts. 

<library> is the file specification of a library file. 

<operations> is a series of module or object file names, each 

preceded by one of three command characters: the plus 
sign <+), the minus sign (-), and the asterisk (*). 
Refer to Table 3-1 for a description of the command 
characters. 

<listing> is the file specification for the file to contain the 
cross-reference listing of PUBLIC symbols in the 
modules in the library. 


The Library Manager provides six command characters, three for required 
responses to prompts and three for optional responses. Refer to Table 3-1. 


Table 3-1. List of Command Characters and Descriptions 


Character 

Description 

Required 

Appends object file specification as 
last module in library (default is 
.OBJ). Removes drive designation 
and extension. 

+ (plus sign) 

- (minus sign) 

Deletes specified module from the 

library file. 

* (asterisk) 

Copies a specified module from a 
library file to a separate object 
file. Adds the default drive 
designation and the file name 
extension .OBJ (cannot be overridden 
but can be renamed or copied). 
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Table 3-1. List of Command Characters and Descriptions (continued) 


Character 

Description 

Optional 


; (semicolon) 

!■ 

Selects default responses to 
remaining prompts (press semicolon 
followed by RETURN). To bypass 
prompts, press RETURN. Refer to 
Section 3.3 for the default 


responses. 

& (ampersand) 

Allows multiple responses to the 
Operation prompt (use with this 
prompt only). 

SHIFT + CANCEL 

Aborts the library session. Use 
when you have entered an erroneous 
response. 


The following are examples of Method 3. 


Example 

LIB PASCAL-HEAP+HEAP; 


LIB PASCAL 


Action 


Delete the module HEAP from 
PASCAL.LIB. Append HEAP.OBJ as 
the last module of PASCAL.LIB. 

Perform a consistency check of 
PASCAL.LIB. 


LIB PASCAL,PASCROSS.PUB Perform a consistency check of 

PASCAL.LIB. Produce 
cross-reference listing file 
PASCROSS.PUB. 


Method 4 


Method 4 allows you to conduct the Library Manager session without 
interactive responses to the Library Manager prompts. 

1. Create a response file. This file contains answers to the Library 
Manager prompts. 

2. Select the DOS Command Processor or Other option from the Main 
System menu. The DOS prompt or a file specification prompt 
appears. 
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3. Enter the following response: 


LIB @<filespec> 


The @<filespec> designates a response file. 


A response file contains text lines, one for each prompt. You must 
arrange the responses in the same order as the command prompts appear. Use 
command characters in the response file the same way you use them for 
responses you enter on the keyboard. 


When the library session begins, 
prompt in turn with the responses from 
file does not contain responses to all 
the default responses. 


the Library Manager displays each 
the response file. If the response 
the prompts, the Library Manager uses 


The following example shows a response file for Method 4 


PASCAL < RETURN > 

-HEAP * FOIBLES +CURSOR+HEAP < RETURN > 
CROSSLST<RETURN> 


This response file causes the Library Manager to delete the module HEAP 
from the PASCAL.LIB library file, extract the module FOIBLES and place it in 
an object file named FOIBLES.OBJ, and then append the object files CURSOR.OBJ 
and HEAP.OBJ as the last two modules in the library. Finally, the Library 
Manager creates a cross-reference file named CROSSLST. 


3.3 COMMAND PROMPTS 


To give commands to the Library Manager, you must enter responses to three 
consecutive text prompts. Refer to Table 3-2. 


When the library session finishes successfully, the Library Manager 
returns you to the place from which you invoked it. If the library session is 
unsuccessful, the Library Manager returns an error message. (Refer to 
Appendix B, Library Manager Messages.) 


The Library Manager prompts you to enter the name of the library fi e, 
the operation you want to perform, and the specification you want to give or 
a cross-reference listing file, if any. 
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Table 3-2. Library Manager Prompts and Descriptions 


Prompt 
Library file: 


Description 

Enter one file specification at a 
time (default is .LIB), 

Use a semicolon to initiate a 
consistency check. 

If file does not exist, enter Y 
to prompt to create one. 


Operation: 


• Enter a +, or *, each followed 
by a module name or an object 
file specification. 

• There is no default. 

• Enter your operation responses in 
any order. 


• Enter a file specification for a 
cross-reference listing file of 
PUBLIC symbols (and its module 
name). 

• An alphabetical list of all 
modules is the library is also 
available (with an alphabetical 
listing of PUBLIC symbols in that 
module). 


• For a consistency check of the 
library file and a cross 
reference listing file, enter a 
library file name, a comma, and a 
list file specification. 
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CHAPTER 4 
THE DEBUGGER 


4.1 INTRODUCTION 


The Debugger (DEBUG.COM) provides a controlled testing environment for 
binary files and executable object files. The Assembler and the 
compilers produce binary files. The Linker produces executable (.EXE) 
files. 


Although you can use the Debugger for programs written in any 
compiled language, many of the Debugger functions require that you 
understand Assembler concepts. Many Debugger functions also require that 
you are familiar with the information on system architecture, the 
operating system, and definitions contained in Chapter 5. While using 
the Debugger, you can alter the contents of a file or the contents of a 
CPU register and immediately reexecute a program to check the validity of 
the changes. 

Use these keys while operating the Debugger: 

• SHIFT + CANCEL — Aborts Debugger commands at any time. 

• CONTROL + S Suspends the display so that you can read the 
display before it scrolls off the screen. 

• Any Key — Restarts the display. 

You can also use the control character and the special editing 
functions available at the DOS command level (refer to The Wang 
Professional Computer Utility Programs User Guide ). —— 
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\.2 INVOKING THE DEBUGGER 


r ou can invoke the Debugger by using one of the following three methods. 
Method 1 


1. Select Program Development from the Main System menu. The 
Program Development menu appears. 

2. Select the Debugger option. The Debugger prompt, a right angle 
bracket (>), appears on the screen. 


iethod 2 


1. Select the DOS Command Processor (COMMAND.COM) option on the 
Main System menu. The DOS prompt A: appears, where A 
represents the default drive. 

2. Respond to this prompt using the following format: 

DEBUG [<filespec> [<argument list>]] 

If you specify a file, the Debugger loads that file into 
memory. You can specify an <argument list> if <filespec> is 
present. The <argument list> contains any file name parameters 
and switches to be passed to the program you are debugging. 

The Debugger loads the specified file into memory as if it had 
been invoked from the DOS Command Processor. 

3. The Debugger prompt appears. 

[ethod 3 

1. Select the Other option from the Main System menu. A prompt 
for a file specification appears on the screen. 

2. Respond to this prompt as you would to the DOS Command 
Processor prompt. 

With any of these methods, you can invoke the Debugger without 
pecifying a file to be debugged by following these steps: 

1. Select Debug Programs from the Program Development menu, or 
enter DEBUG in response to the DOS prompt or the Other file 
specification prompt. The Debugger prompt appears. 

2. Use the N and L commands described in Section 4.6 to specify a 
file to be debugged and load it into memory. 
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CAUTION: 

Once the "program terminated normally" message appears, do not attempt to 
restart the program until you have reloaded the program using the N and L 
commands. 


4.3 INITIALIZATION 


If the program you are debugging is not an .EXE file, the 8086 flags and 
registers have the following initial values when the Debugger program 
begins: 

• The segment registers <CS, DS, ES, and SS) contain the first 
segment after the Debugger program. 

• The Instruction Pointer (IP) contains 0100H. 

• The Stack Pointer (SP) contains the end of the stack segment or 
the low address of the transient portion of COMMAND.COM, 
whichever is lower. (For COMMAND.COM, refer to Section 
5.3.4.) The segment size at Offset 06H in the Program Segment 
Header (PSH) of the program you are debugging is reduced by 
0100H to allow for a stack of that size. 

• The other registers (AX, BX, CX, DX, BP, SI, and Dl) contain 
ze ro. If you invoke the Debugger with a <filespec>, however, 
the BX and CX registers contain the length of the file in bytes. 

• The flags are cleared. (Refer to the Register Command, Section 
4.6, for their cleared values.) 

• The default disk transfer address is Offset 80H in the code 
segment. 

When the Debugger loads an .EXE file, it performs the necessary 
relocating and sets the segment registers. Instruction Pointer, and Stack 
Pointer to the values defined in the file. The DS and ES registers, 
however, contain the address of the PSH at the lowest free segment. 

When you invoke the Debugger, it sets up a PSH at Offset 00H in its 
program work area. If you do not supply a file specification when you 
invoke the Debugger, it sets up a default PSH. You can overwrite the 
default PSH. 


CAUTION: 

Once you give the Debugger a file specification, do not modify the PSH 
below Offset 5CH. Modifications in this area could cause the system to 
crash when it exits from the Debugger. Do not make any modifications 
below 100H. 
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If you specify the appropriate switch when the Linker creates the file 
(refer to Section 2.7), the Debugger loads the program at the high end of 
memory. 


The Debugger assumes a .HEX file contains an ASCII representation of 
hexadecimal characters. The Debugger converts these files to binary while 
loading them. 


4.4 USING THE DEBUGGER 


Each Debugger command consists of a single letter, followed by one or more 
parameters. 

If a syntax error occurs, the Debugger reprints the command line and 
indicates the location of the error with an up arrow (T) and the word error. 
For example: 

dcs:100 cs:110 
T error 

You can enter all commands in any combination of uppercase and lowercase 
letters. 

The Debugger commands are summarized in Table 4-1 and described in 
detail, with examples, in Section 4.6. The Debugger command parameters are 
described in Section 4.5. 


Table 4-1. Debugger Commands 


Function 

DEBUG Command 

Assemble 

A<address> 

Compare 

C<range> <address> 

Dump 

D[<address>] 

D[<range>] 

Enter 

E<address> [<list>] 

Fill 

F<range> <list> 

Go 

G[=<address>] [<address>...3 

Hex 

H<value> <value> 
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Table 4-1. Debugger Commands (continued) 


Function 

DEBUG Command 

Input 

I<value> 

Load 

L[<address> [<drive> <sector> <value>]] 

Move 

M<range> <address> 

Name 

N<filespec>[/S...] [<filespec>[/S. 

Output 

0<value> <byte> 

Proceed 

P[=<address>] 

Quit 

Q 

Register 

R[<register-name>] 

Search 

S<range> <list> 

Trace 

T[=<address>] [<value>] 

Unassemble 

U[<address>] 


U[<range>] 

Write 

W[<address> [<drive> <sector> <value>]] 


4.5 DEBUGGER COMMAND PARAMETERS 


As Table 4-1 shows, all the Debugger commands accept parameters, with the 
exception of the Q command. You can separate parameters with delimiters 
(spaces or commas), but a delimiter is required only between two consecutive 
hexadecimal values. Thus, the following commands are equivalent: 

dcs:100 110 
d cs:100 110 
d,cs:100,110 
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The following is a list of Debugger parameters and their definitions: 
Parameter Definition 

<address> Either an alphabetic segment register designation or a 1- to 
4-digit segment address, followed by a colon and an offset 
value. For example: 



CS:0100 
04BA:0100 


<byte> 


<device> 

<drive> 


The colon is required between a segment designation (whether 
numeric or alphabetic) and an offset. 


You can omit the segment designation or segment address, in 
which case the default segment is used. DS is the default 
segment for all commands, except A, G, L, T, U, and W. For the 
latter commands, the default segment is CS. All numeric values 
are hexadecimal. 

Note that <address>es must reference existing memory locations. 
Otherwise, undefined results occur. 


A 1- or 2-digit hexadecimal value to be placed in or read from 
an address or register. 


A reserved name for a device. 

A 1- or 2-digit hexadecimal value indicating which drive to 
a file from or write it to. The valid values are 0 through 
The values currently assigned to drives are as follows: 


load 



3F. 


<Value> <Drive> 
0 A 

1 B 

2 C 


<filespec> A 1-character to 8-character file name; optionally preceded by a 
1-character drive designation or a path name or both; optionally 
followed by a 1-character to 3-character extension. 

<list> A series of <byte> values or of strings . <list> must be_ the 

last parameter on the command line. 

The following example has three items in the <list>, two byte 
entries, 2A and 42, and one string entry, 'abc'. The Debugger 
fills locations CS:100 through CS: 110 with the items in the 
list, repeating the list until the specified addresses are 
filled: 

fcs:100 L 10 2A 42 'abc' 


r 
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Parameter 
<range> 


<sector> 

Register- 
name V 

<string> 


Definition 

Either two <address>es (<address> <address>) or one <address>, 
an L, and a <value> (<address> L <value>), where <value> is the 
number of lines or bytes the command operates on. The following 
<range> is illegal because the second address includes a 
register: 

CS:100 CS:110 
T error 

If you specify two <address>es, the second must be higher than 
the first and must be specified by an offset only. For example: 

CS:100 110 
CS:100 L 10 

The limit for <range> is 0FFFFH. 

A 1- to 4-digit hexadecimal value used to indicate the physical 
sector on the disk at which loading begins. 

Either a 2-character register name or the character F for 
flags. 

Any number of characters enclosed in quotes. The ASCII values 
of the characters in the string become a <list> of byte values. 
Quotes can be either single (') or double <"). Within 
<string>s, the opposite, set of quote marks can appear freely as 
literals. If the delimiter quote marks must appear within a 
<string>, you must repeat each quote mark, whether single or 
double. For example, the following strings are legal: 

’This "string" is okay.’ 

'This ''string'' is okay.' 

However, this string is illegal: 

'This 'string* is not okay.' 

These strings are legal: 

"This 'string' is okay." 

"This ""string"" is okay." 

However, this string is illegal: 

"This "string" is not okay." 
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The repeated quotations in the following strings are unnecessary 
and should not be there, unless you want them to be part of the 
string: 



"This is a *’string’ 
'This is a ’"’string’'”. • 


<value> A 1- to 4-digit hexadecimal value used to specify a port number, 

the number of times a command repeats its functions, or the 
number of bytes or sectors to be operated on. 


4.6 DEBUGGER COMMANDS 


This section explains the function and syntax of the Debugger commands. It 
also provides examples for each command. 


All files except 


.EXE files begin with the IP at Offset 0100H. 



c 
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4.6.1 A Command (Assemble) 


Function 

This command converts MACRO-86 instructions to binary form and places 
them in memory at an address you specify. 


Format 


A <address> 


<address> either an alphabetic segment register 

designation or a 1- to 4-digit segment address, 
followed by a colon and an offset value. The 
default segment is CS. 


Comments 

1. When you enter this command, the address you specified appears on 
the next line. Enter a statement to be assembled and press RETURN. 

The Debugger converts the statement to machine code, places the values 
in memory, and displays the address of the next available memory 
location. 

2- To terminate the command, press RETURN without entering a response 
to the prompt. 

3. The Debugger responds to invalid statements by displaying the 
following message: 

T Error 

and redisplaying the current assemble address. 

4. In general, the syntax of the Assembly language statements used in 
the A command is standard 8086/8088 Assembly language. The following 
are exceptions to this rule: 

a. The Debugger assumes that all numeric values you enter are 
hexadecimal. 

b. Several prefixes (lock, repeat, and segment override) can 
appear in one statement, but all prefixes must precede the 
opcode of the statement. Alternatively, you can enter a prefix 
on a line by itself. 

c. The Debugger distinguishes between byte and word string 
instructions as follows: 
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Byte 

Word 

LODSB 

LODSW 

STOSB 

STOSW 

SCASB 

SCASW 

MOVSB 

MOVSW 

CMPSB 

CMPSW 


d. The mnemonic for the far return is RETF. The Assembler automatically 
assembles short, near, or far jumps and calls, depending on byte 
displacement to the destination address. You can override the normal 
interpretation of the byte displacement with the NEAR or FAR prefix. 

For example: 

0100:500 JMP 502 ; a 2-byte short jump 

0100:0502 JMP NEAR 505 ; a 3-byte near jump 
0100:0505 JMP FAR 50A ; a 5-byte far jump 

You can abbreviate the NEAR prefix to NE, but you cannot abbreviate the 
FAR prefix. 

e. The segment override mnemonics are CS:, DS:, ES:, and SS:. 

f. Operands that could refer to either a byte or word are ambiguous. You 
must precede them with the prefix WORD PTR or BYTE PTR. You can 
abbreviate these prefixes to BY and WO. For example: 

INC BYTE PTR [BP] 

NOT WO [1234] 

g. Operands that address memory directly must be enclosed in square 
brackets to distinguish them from immediate values. For example: 

ADD AX,5 ;add 5 to register AX 

ADD AX,[5] ;add the contents of memory location 5 to AX 

h. Two additional pseudo-instructions are included. The DB opcode 

assembles byte values directly into memory. The DW opcode assembles 
word values directly into memory. For example: 

DB 1,2,3,4,"THIS IS AN EXAMPLE” 

DB 'THIS IS A QUOTE: M ' 

DB ’’THIS IS A QUOTE: *" 

DW 1000,2000,3000,4000 


i. All forms of the register indirect commands are supported. For example 

ADD BX,34[BP+2].[SI-1] 

POP [BP+DI] 

PUSH [SI] 
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j. All opcode synonyms are supported. For example: 

LOOPZ 100 
LOOPE 100 
JA 200 
JNBE 200 

k. You can enter statements through the Debuggger that the Assembler 
would not allow. For example: 

JMP FAR FFFF:0000 

l. Equates (EQU) are not allowed. 

Example 

>a 3fa:100 

>03fa:0100 MOV BX,AX ; BB CB 

>03£a:0102 CALL [BX].25 ; FF 57 25 
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1.6.2 C Command (Compare) 


^xnction 

This command compares the area of memory whose starting point and length is 
specified by <range> to an area of the same size beginning at <address>. It 
also displays any differences in the areas. 


Format 


C<range> <address> 


<range> 


<address> 


either two <address>es or one <address>, an L, and a 
hexadecimal <value> indicating a length in bytes 
(<address> L <value>). A second <address> must be 
higher than the first and must be an offset only. 

either an alphabetic segment register designation or 
a to 4-digit segment address, followed by a colon 
and an offset value. The default segment is DS. 


Comments 

1 , if the two areas of memory are identical, no display appears. The C 
command terminates, and the Debugger prompt returns to the screen. 

2. If the two areas are different, they are displayed in the following 
format: 


<addressl> <bytel> <byte2> <address2> ... 


Examples 

The following commands have the same result: 

C100,1FF 300 
C100 L 100 300 

Each command compares the block of memory from 100H to 200H with the block 
of memory from 300H to 400H. 
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4.6.3 D Command (Dump) 


Function 

This command displays the contents of a series of bytes in memory. 


Formats 


1. D[<address>] 
<address> 


either an alphabetic segment register 
designation or a 1- to 4-digit segment address, 
followed by a colon and an offset value. The 
default segment is DS. 


2. D<range> 

<range> either two <address>es or one <address>, an L, 

and a <value> (<address> L <value>). A second 
<address> must be higher than the first and must 
be an offset only. 


Comments 


1. If you specify a single address only, the Debugger displays the contents 
of 128 bytes beginning at that address. If you specify a range of 
addresses, the Debugger displays the contents of the range. If you enter 
the D Command without parameters, the Debugger displays the contents of 128 
bytes beginning at the current location in the DS segment. 

For the first D Command, the current location is at Offset 0100H. For 
subsequent commands, the current location is that following the last address 
displayed. 

2. The display has two parts: a part that shows each byte as a hexadecimal 
value and a part that shows the bytes as ASCII characters. Bytes that do 
not contain printable characters are denoted by a period (.) in the ASCII 
portion of the display. 

3. Each display line shows 16 bytes with a hyphen between the eighth and 
ninth bytes. 

4 ‘ Each displayed line begins on a 16-byte boundary, unless the starting 
address specified in the command is not at a boundary. In that case, the 
first line can contain fewer than 16 bytes, and the second line begins at a 
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Examples 


Assume that you enter the following command: 
dcs:100 110 

The following display appears: 



04BA:0100 42 45 52 54 41 20 54 00-20 42 4F 52 4C 41 4E 44 BERTA T. BORLAND 
04BA:0100 2E 


Assume that you enter the following command: 

D 

The Debugger displays 128 bytes, with each line of the display formatted as 
described in the Comments above. Each line of the display begins with an 
address incremented by 16 from the address on the previous line. Subsequent 
D Commands entered without parameters display the bytes immediately 
following those last displayed. 

Assume that you enter the following command: 


DCS:100 L 20 


The display is formatted as described above, 
are displayed. 

Assume that you enter the following command: 


but all the bytes for 20H bytes 



c 


DCS:100 115 

The display is formatted as described above, but all the bytes in the range 
of lines from 100H to 115H in the CS segment are displayed. 


c 


The Debugger 



4-15 


4.6.4 E Command (Enter) 



unction 


This command displays bytes one at a time and allows you to modify their 
contents. 


Format 


E<address> [<list>] 
<address> 


<list> 


either an alphabetic segment register designation or 
a 1- to 4-digit segment address, followed by a colon 
and an offset value. The default segment is DS. 

a series of <byte> values or of characters enclosed 
in quotes. 


Comments 


1. If you enter the optional <list> of hexadecimal values, the replacement 
of byte values occurs automatically. If an error occurs, byte values remain 
unchanged. 


2. If you enter the <address> without the optional <list>, the Debugger 
displays the address and its contents, then repeats the address on the next 
line and waits for your input. At this point, the E Command waits for you 
to perform one of the following actions: 

a. Replace a byte value with one that you type in. Type the value 
after the current value, at the cursor position. If the value you 
type is not a legal hexadecimal value or if you type more than two 
digits, a bell sounds and the illegal or extra character is not 
moved to memory. 

b. Press the space bar to display the next byte. To change the value, 
enter the new value as described in 2a above. If you space beyond 
an 8-byte boundary, the Debugger starts a new display line with the 
address displayed at the beginning of the line. 

c. Type a hyphen (-) to return to the preceding byte. If you decide to 
change a byte before the current byte, type the hyphen to return to 
the current position to the previous byte. When you type the 
hyphen, a new line starts with the address of the byte, and its 
value is displayed. 
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d. Press RETURN to terminate the E Command. You can press RETURN at 
any byte position. 


CAUTION: 

You should not use the E Command to change video memory because video memory 
is word-oriented. 


Example 

Assume you enter the following command: 

ECS:100 

The Debugger displays the following: 

04BA:0100 EB._ 

To change this value to 41, enter 41 as follows: 

04BA:0100 EB.41_ 

To step through the subsequent bytes, press the space bar. The following 
line appears: 

04BA:0100 EB.41 10. 00. BC._ 

To change BC to 42, enter 42 as follows: 

04BA:0100 EB.41 10. 00. BC.42_ 

To change the 10 to 6F at location 04BA:0101, enter the hyphen as many times 
as needed to go to Byte 0101 (value 10), then replace 10 with 6F, as follows 

04BA:0100 EB.41 10. 00. BC.42- 

04BA:0102 00.- 

04BA:0101 10.6F_ 

Press RETURN to end the E Command and return to the Debugger command level. 
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4.6.5 F Command (Fill) 

Function 

This command fills the addresses in the <range> with the values in the 
<list>. 


Format 


F<range> <list> <value> 

either two <address>es or one <address>, an L, and a 
<value> (<address> L <value>). A second <address> 
must be higher than the first and must be an offset 
only. 

a series of <byte> values or characters enclosed in 
quotes. 

a 1- to 4-digit hexadecimal block length. 

Comments ~ 

!• The F Command is similar to multiple E Commands in that it allows you to 
change more than one address at a time. The F Command does not abort on an 
error as the E Command does. If any of the memory in the <range> is not 
valid (bad or nonexistent), the remaining portions of the <range> may 
receive incorrect data. 

2. If the <range> contains more bytes than the number of values in the 
<list>, the command uses the <list> repeatedly until all bytes in the 
<range> are filled. If the <list> contains more values than the number of 
bytes in the <range>, the command ignores the extra values in the <list>. 


<range> 

<list> 

<value> 


CAUTION: 

You should not use the F Command to change video memory because video memory 
is word-oriented. 


Exampl e 

Assume you enter the following command: 

FCS:100 L 100 42 45 52 54 41 

The Debugger fills memory locations CS:100 through CS.-200 with the bytes you 
specified. The five values are repeated until all 100H bytes are filled. 
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4.6.6 G Command (Go) 


Function 

This command executes the program currently in memory. Optionally, it stops 
the execution at a specified breakpoint and displays registers, flags, and 
the decoded instruction. 


Format 


G[=<address>] [<address>...] 

<address> either an alphabetic segment register designation or 

a 1- to 4-digit segment address, followed by a colon 
and an offset value. The default segment is CS. 


Comments 


1. If you enter the G Command with no parameters, the program executes as 
if the program had run outside the Debugger. 

2. If you specify =<address>, execution begins at that address. If you 
omit the segment designation from =<address>, the command sets the 
instruction pointer only. If you include the segment designation in 
=<address>, the command sets both the CS segment and the instruction 
pointer. The equal sign (=) is required, so that the Debugger can 
distinguish the start <address> from the breakpoint <address>es. 

3. With the breakpoint <address> list set, execution stops at whatever 
breakpoint <address> is encountered first, no matter which branch the 
program takes. When program execution reaches a breakpoint, the registers, 
the flags, and the decoded instruction are displayed for the next 
instruction. (The result is the same as if you entered the R Command for 
the breakpoint address.) 

4. You can set up to ten breakpoints. Because breakpoints are 
instruction—oriented, you can set them only at the address of the first byte 
of an instruction. If you set more than 10 breakpoints, the Debugger 
returns the BP error message, which means there are too many breakpoints. 

5. After an executing program encounters a breakpoint, if you enter the G 
Command again, all breakpoints are removed. The only difference is*that 
program execution resumes at the instruction after the breakpoint rather 
than at the usual start address. 
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6. The user Stack Pointer must be valid, and the stack must have six bytes 
available for this command. The G Command uses a IRET instruction (Return 
from Interrupt) to cause a jump to the program under test. The command sets 
the user Stack Pointer and pushes the user flags. Code Segment register, and 
Instruction Pointer onto the user stack. 


CAUTION: 

If the user stack is not valid or is too small, the operating system may 
crash. 


7. The G Command places a 1-byte interrupt opcode (CCH) at the breakpoint 
address(es) you specify. The Debugger reserves an area of memory to save 
the original instructions from those addresses. When the executing program 
encounters an instruction with the breakpoint code, the Debugger restores 
all breakpoint addresses to the original instructions. If execution does 
not stop at one of the breakpoints, the interrupt codes are not replaced 
with the original instructions. 


Example 

Assume you enter the following command: 

GCS:7550 

The program currently in memory executes to address 7550H in the CS 
segment. The Debugger displays registers and flags. Then, the Debugger 
prompt appears. 
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4.6.7 H Command (Hex Arithmetic) 


Function 

This command performs hexadecimal arithmetic on the two parameters. 


Format 


H<value> <value> 

<value> a hexadecimal number. 

Comments 

The Debugger adds the two parameter values, and then subtracts the 
second parameter from the first. The results appear on one line, first the 
Siam and then the difference. 

Example 

Assume you enter the following command: 

H10A 19F 

The Debugger performs the calculations and then returns the results: 

02A9 FF6B 
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4.6.8 I Command (Input) 

Function 

This command inputs and displays one byte from the port specified by <value> 

Format 

I<value> 

<value> a x- to 4-digit hexadecimal number. 

Comments 

A 16-bit port address is allowed. 

Example 

Assume you enter the following command: 

I10FE 


the byt6 at the port contains 00H. 
byte and displays the following value: 


The Debugger inputs the 


00 
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4.6.9 L Command (Load) 

Function 

This command loads a file into memory. 


Format 


L[<address> [<drive> <sector> <value>]] 

<address> either an alphabetic segment register designation or 

a 1- to 4-digit segment address, followed by a colon 
and an offset value. The default segment is CS. 


<drive> 

<sector> 


<value> 


a 1- to 2-digit hexadecimal number. 

a 1- to 4-digit hexadecimal number used to indicate 
the physical sector on the disk at which loading 
begins. 

a 1- to 4-digit hexadecimal number. 


Comments 

1. If you do not include <address>, <drive>, <sector>, or <value>, you must 
have previously named the file either when invoking the Debugger or in the 
most recently issued N Command. Both the invocation and the N Command 
format a file name properly in the normal format of a File Control Block at 
CS:5C. (Refer to Sections 5.3.5, Program Initialization, and 5.4.1, File 
Control Block.). If the file does not exist, a File Not Found message 
appears. 

2. If you specify a file or part of a file that is too large to fit in 
available memory, the L Command aborts, and the Debugger prompt returns to 
the screen. 

3. If you enter the L Command without any parameters, the Debugger loads 
the file into memory beginning at address CS:100 and sets BX:CX to the 
number of bytes loaded. If you enter the L Command with an <address> 
parameter, loading begins at the memory address you specify, with BX:CX set 
to the number of bytes loaded. If you enter L with all parameters, the 
Debugger loads absolute disk sectors, not a file. 

The Debugger takes <value> sectors from the <drive> you specify. The drive 
designation is numeric (0=A:, 1=B:, 2=C:). The Debugger begins loading with 
the first <sector> you specify and continues until it loads the number of 
sectors you specify in <value>. 
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4. If the file has an .EXE extension, it relocates to the load address 
specified in the header of the .EXE file. For .EXE files, the Debugger 
always ignores the <address> parameter of the L Command. Note that the 
header itself is removed from the .EXE file before it is loaded into 
memory. Thus, the size of a .EXE file on disk differs from its size in 
memory. 


5. If the file you named with the N Command or specified on invocation is a 
.HEX file, then entering the L Command with no parameters causes loading of 
the file beginning at the address specified in the .HEX file. If the L 
Command includes the <address> parameter, the Debugger adds the address 
specified in the L Command to the address found in the .HEX file to 
determine the start address for loading the file. 


Examples 

Assume you enter the following commands: 

A:DEBUG 
>NFILE.COM 

Now, to load FILE.COM, enter: 

L 

The Debugger loads the file and displays the Debugger prompt. 

Assume you want to load portions of a disk. To do this, enter: 

LCS:100 0 OF 6D 

The Debugger then loads 109 (6D hex) sectors, starting with absolute Sector 
15, into memory beginning at address CS:0100. When the Debugger has loaded 
the sectors, it displays the Debugger prompt. 
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4.6.10 M Command (Move) 

Function 

This command moves the block of memory specified by <range> to the location 
beginning at the specified <address>. 


Format 


M<range> <address> <value> 

<range> either two <address>es or one <address>, an L, and a 

<value> (<address> L <value>). A second <address> 
must be higher than the first and must be an offset 
only. 

<address> either an alphabetic segment register designation or 

a 1- to 4-digit segment address, followed by a colon 
and an offset value. The default segment is DS. 


<value> 


a 1- to 4-digit hexadecimal block length. 


Comments 

The M Command performs overlapping moves (where the source and 
destination areas have some common addresses) without loss of data. It 
moves the data that could be overwritten first. The sequence for moves from 
higher addresses to lower addresses is to move the data beginning at the 
block*s lowest address and work toward the highest. The sequence for moves 
from lower addresses to the higher addresses is to move the data beginning 
at the block's highest address and work toward the lowest. 


CAUTION: 

You should not use the M Command to change video memory because video memory 
is word-oriented. 


Example 

Assume you enter the following: 

MCS:100 110 CS:500 

The Debugger first moves address CS:110 to address CS:510. Then, it moves 
CS:10F to CS:50F and so on, until it moves CS:100 to CS:500. To review the 
results of the move, enter the D Command using the <address> entered for the 
M Command. 
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4.6.11 N Command (Name) 


Function 

This command performs two distinct functions. First, you can use N to 
assign a file specification for a later L or W Command. Second, you can use 
N to pass file specifications as parameters to the file you are debugging. 


Format 


N<filespec>[<parameter>..,][-S...] 


<filespec> 


<parameter> 


<-S> 


a 1-character to 8-character file name; optionally 
preceded by a 1-character drive designation or a 
path name or both; optionally followed by a 
1-character to 3-character extension. 

a 1-character to 8-character file name; optionally 
preceded by a 1-character drive designation and/or a 
path name; optionally followed by a 1-character to 
3-character extension. 

any DOS switch set for the specified file. 


Comments 

1. If you invoke the Debugger without naming any file to be debugged, you 
must enter the N Command before the Debugger can load a file. 

2. The N Command can affect four distinct regions of memory; 

DS:5C FCB for File 1 
DS:6C FCB for File 2 
DS:80 Count of characters 

DS:81 All characters entered, changed to uppercase 
Refer to Section 5.3.5 for a description of these areas. 

3. The Debugger sets up a File Control Block (FCB) for the first file 
specification in the N Command at DS:5C. (Refer to Section A.4.1.) If you 
give a second file specification, the Debugger sets up an FCB for it 
beginning at DS:6C. Location DS:80 contains the number of characters you 
type in the N Command (exclusive of the first character, N). The characters 
in the N Command (again, exclusive of the letter N) begin at DS:81. Note 
that these characters can contain switches and delimiters that are legal in 
any command typed at the DOS command level. 
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4. The functions of assigning a file specification for L and W Commands and 
of passing file specification parameters overlap. Consider the following 
set of the Debugger commands: 

>NFILE1 .EXE 

>L 

>G 

Because of the 2-pronged effect of the N Command, the following steps 
occur: 

a. N assigns the extended file name FILE1.EXE to any later Load or 
Write Commands. 

b* N also assigns the extended file name FILE1.EXE as the first file 
specification parameter used by any program that is later debugged. 
(See Paragraph d, below.) 

c. L loads FILE1.EXE into memory. 

d. G executes FILE1.EXE. FILE1.EXE also acts as the single file 
specification parameter (that is, FILE1.EXE executes as if you had 
typed FILE1.EXE at the DOS command level.) 

A more useful set of commands is as follows: 

>NFILE1.EXE 
>L 

>NFILE2.DAT FILE3.DAT 
>G 

In this example, N sets FILE1.EXE as the file specification for the 
subseguent L Command. (You can also use the DEBUG Command for this 
purpose.) The L Command loads FILE1.EXE into memory. Then, the N Command 
specifies the parameters used by FILE1.EXE. Finally, when the G Command 
executes, FILE1.EXE runs as if you had typed FILE1 FILE2.DAT FILE3.DAT at 
the DOS command level. 

If you enter a W Command at this point, the file you are. debugging 
(FILE1.EXE) is saved with the name FILE2.DAT. To avoid such undesired 
results, always execute an N Command before an L or W. 
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DEBUG PROG.COM 
NPARAM1 PARAM2/C 
G 

In this example, the G Command executes the file in memory as if you entered 
the following DOS command line: 

PROG PARAM1 PARAM2/C 

Testing and debugging, therefore, reflect a normal runtime environment for 
PROG.COM. 


The Debugger loads PROG.COM at DS:100. This file specification is placed in 
the FCB at DS:5C. Then N formats FCBs for PARAM1 and PARAM2/C at DS:5C and 
DS:6C, respectively, overwriting the FCB for PROG.COM. 
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4.6.12 0 Command (Output) 


Function 

This command sends the <byte> specified to the output port specified by 
<value>. 


Format 

0<value> <byte> 

a 1- to 4-digit hexadecimal number. 

a 2-digit hexadecimal value to be placed in the 
output port. 


<value> 

<byte> 


Comments 

1. A 16-bit port address is allowed. 

2. The 0 Command operates on byte-oriented ports only, not on word-oriented 
ports such as those for the video card. 


Example 

Assume you enter the following: 

02F8 4F 

The Debugger outputs the byte value 4F to output Port 2F8. 
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4.6.13 P Command (Proceed) 



Like the T Command, this command executes one or more instructions, 
displaying the contents of all registers and flags after execution, and 
displaying the next instruction in decoded format. (Refer to Section 
4.6.17, T Command). However, the P Command allows you to treat the 
following instructions as atomic operations: 

Software interrupts 
Subroutine calls 
Repeat-string instructions 
Loop instructions 


NOTE: 

The P Command is available in Version 2.30 or later. 


Format 


P[=<address>] 


<address> 



either an alphabetic segment register designation or 
a 1- to 4-digit segment address, followed by a colon 
and an offset value. The default segment is CS. 


The P Command is extremely useful in tracing across system calls (INT 
21H) and procedure calls in programs that contain many procedures. 


Example 

Assume you enter the following: 
P 


The P Command causes one or more instructions to execute. If subroutine 
calls, interrupts, repeat-string instructions, or loop instructions are 
encountered, the P Command treats them as a single operation instead of 
several individual instructions. 


) 
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Assume the following instructions are run: 

0100: CALL 1000 

0103: JC 0200 

1000: XOR AX, AX 

Ixxx: RET 

The P instruction treats the entire subroutine at location 1000 as a 
single operation. At the JC instruction, you regain control over the 
operation. 
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4.6.14 Q Command (Quit) 


function 

This command terminates the Debugger program. 


Format 

Q 


Comments 

. 2 Command takes no parameters and exits the Debugger without saving 

the file currently being operated on. Then, Q returns you to the program 
from which you invoked the Debugger. 

Example 

To end the Debugger program, enter the following and then press RETURN: 

Q* 

The Debugger terminates and returns control to the level from which vou 
entered the Debugger. 1 
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4.6.15 R Command (Register) 


Function 

This command has three functions: 

1. R can display the contents of a CPU register and allow you to change its 
contents. 

2. R can display the eight flag settings and allow you to change them. 

3. R can display the contents of all the registers, the flag settings, and 
the next instruction to be executed, in decoded format. 

Format 

R[<register-name>] 

<register-name> either a 2-character register name or the character 
F for flags. 


Comments 

1. If you do not enter a <register-name>, the R Command dumps the register 
save area and displays the contents of all registers and flags. 

At start up, the segment registers contain the bottom of free memory, the 
Instruction Pointer contains 0100H, the Stack Pointer contains FFFEH, all 
flags clear, and the remaining registers contain zero. 

2 If you enter a register name, the Debugger displays the 16-bit value of 
that register in hexadecimal, and then a colon appears as a prompt. You 
then enter a <value> to change the register or press RETURN if you do not 
want a change. 


3. The only valid <register-names> are as follows. (IP and PC both refer 


to the instruction 

pointer.) 

AX 

BP 

SS 

BX 

SI 

CS 

cx 

DI 

IP 

DX 

DS 

PC 

SP 

ES 

F 

Any other 

entry for <register-name> results in a BR (Bad Register) error 


message. 
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4. If you enter P as the <register-name>, the Debugger displays eight 
2-character alphabetic codes. To alter the flag, enter the opposite 
2-letter code. The flags are either set or clear. 

Table 4-2 lists the flags with their codes for set and clear. 


Table 4-2. Flags and Flag Codes 


Flag Name 

Set 

Clear 

Overflow 

OV 

NV 

Direction 

DN (Decrement) 

UP (Increment) 

Interrupt 

El (Enabled) 

DI (Disabled) 

Sign 

NG (Negative) 

PL (Plus) 

Zero 

ZR 

NZ 

Auxiliary Carry 

AC 

NA 

Parity 

PE (Even) 

PO (Odd) 

Carry 

CY 

NC 


5. When you enter the command RF, the Debugger displays the flags in a row 
at the beginning of a line, in the order shown in Table 4-2. At the end of 
the list of flags, the Debugger displays a hyphen (-), then the Debugger 
prompt (>). You can enter new flag values as alphabetic pairs and in any 
order. You are not required to leave spaces between the flag entries. 

Press RETURN to exit the R Command. Flags with no new values are unchanged. 

y ° U enter m ° re than one value for a fla 9' the Debugger returns a DF 
(Double Flag) error message. If you enter a flag code other than those 
shown in Table 4-2, the Debugger returns a BF (Bad Flag) error message. In 

^? th _ Ca f 8S '. th ?. flags up to the error in the list are changed. However, 
rjags at and after the error are not changed . 
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Examples 

Assume you enter the following: 

R 

The Debugger displays all registers, flags, and the decoded instruction for 
the current location. If the location is CS:11A, then the Debugger might 
display: 

AX=0E00 BX=00FF CX=0007 DX-01FF SP=039D BP=0000 SI=005C DI-0000 
DS=04BA ES=04BA SS=04BA CS=04BA IP=011A NV UP DI NG NZ AC PE NC 
04BA: 011A CD21 INT 21 

Assume you enter the following: 

RF 

The Debugger displays the flags: 

NV UP DI NG NZ AC PE NC - 

Now, enter any valid flag designation, in any order, with or without 
spaces. For example: 

NV UP DI NG NZ AC PE NC - PLEICY 

The Debugger responds only with the Debugger prompt. To see the changes, 
enter either the R or RF Command: 

RF 

NV UP El PL NZ AC PE CY - 

Enter different flag values or, if you want the flags to remain this way, 
press RETURN. 
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4.6.16 S Command (Search) 


Function 

This command searches the <range> specified for the specified <list>. 


Format 


S<range> <list> <value> 


<range> 


<list> 


either two <address>as cr one <address>, an L, and a 
<value> (<address> L <value>). A second <address> 
must be higher than the first and must be an offset 
only. 

a series of <byte> values or of characters enclosed 
in quotes. 


<value> a 1- to 4-digit hexadecimal block length. 

Comments 

1. The list can contain one or more values, each separated by a space or a 
comma. If the list contains more than one value, the Debugger displays the 
starting address of each matching byte-string in the range. If the list 
contains only one value, the Debugger displays the addresses of all the 
bytes in <range> containing that value. 


2. If the Debugger prompt returns with no other display, 
no match for the list in the range. 


the search found 


Example 

Assume you enter the following: 

SCS:100 110 41 

The Debugger could return the response: 

04BA:0104 
04BA:010D 
> 


The Debugger 


4-36 


4.6.17 T Command (Trace) 


Function 

This command executes one or more instructions, displaying the contents of 
all registers and flags after execution, and displaying the next instruction 
in decoded format. 


Format 


T[=<address>] [<value>] 

<address> either an alphabetic segment register designation or 

a 1- to 4-digit segment address, followed by a colon 
and an offset value. The default segment is CS. 

<value> a 1- to 4-digit hexadecimal repeat count. 


Comments 


1. If you enter the optional =<address>, tracing occurs at the address 
specified. If the address includes the segment designation, then both the 
CS register and the instruction pointer are specified. If the address omits 
the segment designation, only the instruction pointer is specified. 

2. The optional <value> causes the Debugger to execute and trace the number 
of instructions specified by <value>. 

3. The 8086 processor does not allow single-stepping for instructions that 
alter segment registers. Thus, a single invocation of the T Command may 
cause two instructions, for example, MOV SS, AX and MOV SP, DX, to execute. 
The T Command then displays the contents of the registers and flags after 
the execution of the second instruction, not the first. And it does not 
display the second instruction at all, but the instruction following it. 
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Assume you enter the following: 

T 

The command causes one (or two, as in the last comment) instructions to 
execute. Then, it returns a display of the registers, flags, and the 
decoded instruction for the address now referenced by the Instruction 
Pointer. Assume that the address of the next instruction is 04BA:011A; then 
the Debugger might return the following display: 

AX=0E0C BX=00FF CX=0007 DX-01FF SP=039D BP=00G0 
SI=005C DI-0000 DS=04BA ES=04BA SS=04BA CS=04BA 
IP=011A NV UP DI NG NZ AC PE NC 
04BA:011A CD21 INT 21 

Now, enter the following command: 

T=011A 10 

The Debugger executes ten instructions beginning at 011A in the current 
segment and then displays all registers and flags for each instruction as it 
is executed. The display scrolls away until the last instruction has 
executed. Then the display stops, and you can see the register and flag 
values for the last few instructions performed. Remember that CONTROL + S 
suspends the display at any point, so that you can study the registers and 
flags for any instruction. Pressing any key resumes the display. 
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4.6.18 U Command (Unassemble) 


Function 

This command disassembles bytes and displays the source statements that 
correspond to them, along with addresses and hexadecimal byte values. 


Formats 


1. U[<address>][<value>] 


<address> 


<value> 
2. U<range> 
<range> 


either an alphabetic segment register designation or 
a 1- to 4-digit segment address, followed by a colon 
and an offset value. The default segment is CS. 

a 1- to 4-digit hexadecimal repeat count. 


either two <address>es or one <address>, an L, and a 
<value> (<address> L <value>). A second <address> 
must be higher than the first and must be an offset 
only. 


Comments 


1. The display of disassembled code looks like a listing for an assembled 
source file. 

2. If you enter the U Command without parameters, the Debugger disassembles 
20H bytes, starting from CS:IP, to show the corresponding instructions. If 
you enter the U Command with the <range> parameter, the Debugger 
disassembles all bytes in the range up to 20 bytes. If there are fewer than 
20H bytes in the <range>, the Debugger displays only that many bytes. 

3. If you enter the U Command with the <address> parameter only, the 
Debugger disassembles the default number of bytes, beginning at the address 
specified. If you enter the U Command with the <address> L <value> 
parameters, the Debugger disassembles all bytes beginning at the address 
specified for the number of lines specified by <value>. Entering the U 
Command with the <address> L <value> parameters overrides the default limit 
(2OH bytes). 

4. If you have used the E Command to alter the bytes in some addresses, the 
disassembler alters the corresponding source instructions. You can enter 
the U Command to view the changed locations and use the disassembled code to 
edit the source file. 

5. For the U Command, the syntax of Assembly language statements differs 
slightly from the standard 8086/8088 Assembly language. Comment 4 in 
Section 4.6.1 lists the differences. 
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Examples 


Assume you enter the following: 
U04BA:100 


The Debugger disassembles 20 bytes beginning at address 04BA:0100, as 
follows: 


04BA:0100 

BA7406 

MOV 

DX, 0674 

04BA:0103 

OE 

PUSH 

CS 

04BA:0104 

IF 

POP 

DS 

04BA:0105 

E8F802 

CALL 

0420 

04BA:0108 

EB12 

JMP 

013C 

04BA:010A 

CD21 

INT 

21 

04BA:010C 

72D5 

JB 

0103 

04BA:010E 

50 

PUSH 

AX 

04BA:010F 

B44D 

MOV 

AH,4D 

04BA:0111 

CD21 

INT 

21 

04BA:0113 

2E 

CS: 


04BA:0114 

A22F07 

MOV 

[072F],AL 

04BA.-0117 

80FC01 

CMP 

AH,01 

04BA:011A 

7403 

JZ 

013F 

04BA:011C 

E98000 

JMP 

01BF 

Q4BA:011F 

58 

POP 

AX 

ime you enter the following: 


u04ba:0100 

0108 



display shows: 



04BA:0100 

BA7406 

MOV 

DX, 0674 

04BA:0103 

OE 

PUSH 

CS 

04BA:0104 

IF 

POP 

DS 

04BA:0105 

E8F802 

CALL 

0420 

04BA:0108 

EB12 

JMP 

013C 


However, if you enter either of the following: 
u04ba:100 120 
UCS:100 L 20 


the display appears exactly the same as above with the UCS:100 command. 
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4.6.19 W Command (Write) 

Function 

This command writes the file being debugged to a disk file. 


Format 


W[<address> [<drive> <sector> <value>]] 


<address> 


<drive> 

<sector> 


<value> 


either an alphabetic segment register designation or 
a 1- to 4-digit segment address, followed by a colon 
and an offset value. The default segment is CS. 

a 1-digit hexadecimal value. 

a 1- to 4-digit hexadecimal value used to indicate 
the physical sector on the disk at which writing 
begins. 

a 1- to 4-digit hexadecimal number specifying the 
number of sectors to write. 


Comments 

1. You must have previously named the file with the Debugger invocation or 
with the N Command. Both methods format a file name properly in the file 
control block at DS:5C. (Refer to Section A.4.1, File Control Block.) If a 
subsequent N Command has changed the original file name, issue another N 
Coronand to change the file name back, before writing the original file. 

2. The Debugger writes the debugged file over the original file, or to a 
new file if the file named in the file control block at CS:5C did not 
previously exist. However, the Debugger does not rewrite .EXE files. If 
you load and modify a file before writing it to disk, the Debugger sets the 
date and length correctly to save the modified file. 

3. If you enter no parameters, BX:CX defines the number of bytes to be 
written, and the starting address is CS:100. If a G, R, or T Command has 
changed these values, or if new values are needed, you must explicitly reset 
them before entering the W Command without parameters. (You can use, the R 
Command to reset them.) 

4. If you enter the W Command with parameters, the write begins from the 
memory address you specify. W writes the file to the drive specified. The 
drive designation is numeric here — 0 for Drive A, 1 for Drive B, 2 for 
Drive C, and so on. The Debugger writes into the file beginning at the 
specified <sector>, and continues until it writes the number of sectors 
specified in <value>. 


The Debugger 


4-41 


CAUTION: 




Examples 

Assume you enter the following: 


displays the Debu " er ^ 

Assume you enter the following: 

WCS.-100 1 37 2B 

sriS^rs.'Ssr^sfrf th t e ? r;*” 

sector number 37H and consists of 2BH records Sh^ Se It t phy3i ? al 
the Debugger prompt appears. " the rite ls complete. 
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CHAPTER 5 

SYSTEM ARCHITECTURE, OPERATING SYSTEM, AND FILE MANAGEMENT 


5.1 INTRODUCTION 


This chapter presents information on the system architecture, the operating 
system, and file management. You should use this information only if you have 
previous experience with assembly language programming. 

This chapter provides a technical overview of the Intel 8086 processor, 
the Wang PC menu driver program, and the Microsoft Disk Operating System (DOS) 
as implemented on the Wang PC. The information presented here is of value to 
those using the Wang PC Assembler, compiled languages. Debugger, or Linker. 

The 8086 processor is the central processor of the Wang PC. 


).2 


Architecture Overview 


This section is an overview of the 8086 processor, describing registers, 
memory segmentation, status and control flags, storage organization, and 
address generation. 


5.2.1 Registers and Flags 


The 8086 uses twelve 16-bit registers. Eight are general registers, and four 
are segment registers. In addition, there are a 16-bit instruction pointer 
(IP), six 1-bit status flags, and three 1-bit control flags. 

General Registers 

The general registers fall into two groups: a group of four data registers and 
a group of four pointer and index registers. Figure 5-1 gives the name, 
function, and group for the general registers. As Figure 5-1 indicates, you 
can address the upper and lower halves of the data registers separately. 

Thus, each data register can function interchangeably as a 16-bit register, or 
as two 8-bit registers. The other registers always function as 16-bit units. 
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Al 


Accumulator 



15 8 7 0 



Destination 

Index 


Figure 5-1. General Registers - 


nentation and Segment Registers 


The 8086 has a physical address space of one megabyte. Programs view the 
megabyte of memory space as a collection of logical "segments". A segment is 
a unit of memory up to 64KB long. Each segment is made up of contiguous 
memory locations and is a separately addressable unit. The system assigns 
every segment a base address, which is its starting location in physica 
memory. All segments begin on paragraph (16-byte) boundaries. As Figure 5-2 
shows, segments may be adjacent, disjoint, partially overlapped, or fully 
overlapped. More than one logical segment can contain the same physical 
memory location. 


System Architecture, Operating System, and File Management 







Phy$*c*i 

Memory 


Figure 5-2. Relations of Logical Segments to Physical Memory 


The system uses the four segment registers to hold the base addresses of 
currently addressable segments. The CS register points to the current code 
segment; instructions are contained in this segment. The SS register points 
to the current stack segment; stack operations use locations in this segment. 
The DS register points to the current data segment; it generally contains 
program variables. The ES register points to the current extra segment, which 
is also typically used for data storage. 

Flags 


The status flags reflect properties of the results of arithmetic or logical 
operations. Different machine instructions affect the flags differently. In 
general, however, the status flags reflect the following conditions: 

• If AF (auxiliary carry flag) is on, there has been a carry out of 

the low four bits into the high four bits or a borrow from the high 

four bits into the low four bits of an 8-bit quantity (low-order 
byte of a 16-bit quantity). Decimal arithmetic instructions use 
this flag. 

• If CF (carry flag) is on, there has been a carry out of, or a borrow 

into, the high-order bit of the result (8- or 16-bit). This flag is 

used for add and subtract instructions. Rotate instructions can 
also isolate a bit in memory or a register by placing it in the 
carry flag. 
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• If OF (overflow flag) is on, an arithmetic overflow has occurred; 
that is, a significant digit was lost because the size of the result 
exceeded the capacity of its destination location. An Interrupt On 
Overflow instruction is available that generates an interrupt in 
this situation. 

• If SF (sign flag) is on, the high-order bit of the result is a 1. 
Since negative binary numbers are represented in the standard two's 
complement notation, SF indicates the sign of the result (0 = 
positive, 1 = negative). 

• If PF (parity flag) is on, the result has even parity, an even 
number of 1-bits. 

• If ZF (zero flag) is on, the result of the operation is 0. 

Programs can set and clear the three control flags to alter processor 
operations as follows: 

• Setting DF (direction flag) causes string instructions to 
auto-decrement; that is, to process strings from high to low 
addresses, or from right to left. Clearing DF causes string 
instructions to auto-increment, or to process from left to right. 

• Setting IF (interrupt-enable flag) allows the CPU to recognize 
external (maskable) interrupt requests. Clearing IF disables these 
interrupts. IF has no effect on either nonmaskable external or 
internally generated interrupts. 

• Setting TF (trap flag) puts the processor into single-step mode for 
debugging. In this mode, the CPU automatically generates an 
internal interrupt after each instruction, allowing the debugger to 
inspect a program as it executes, instruction by instruction. 
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Figure 5-3 shows the usage of the control and status flags. 


Control 

Flags 


Status 

Flags 



Figure 5-3. Flags 


5.2.2 Memory 


This section describes memory organization and physical address generation 


Storage Organization 

From a storage point of view, memory spaces are identical arrays of 8-bit 
bytes. The system always stores word data with the most significant byte in 
the higher memory location. For example, in Figure 5—4 the value of the word 
stored at Address 724H is 5502H. 



Most Significant Least Significant 

Value of Words Stored at 724H:5502H 


Figure 5-4. Storage of Word Variables 
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Doubleword data items, used to hold addresses outside the segments 
currently pointed to by the segment registers, contain an offset value in the 
lower-addressed word and a segment base address in the higher-addressed word. 
Again, the higher-addressed byte of each word contains the most significant 
byte of the word. For example, in Figure 5-5 the value of the pointer stored 
at address 0004H is segment base Address 3B4CH and Offset 0065H. 



Segment Bese Address: 3B4CH 
Offset: 0065H 


Hex 


Binary 


Figure 5-5. Storage of an Address in a Doubleword 


Physical Address Generation 


Every memory location can be thought of as having two kinds of addresses, 
physical and logical. A physical address is the 20-bit value that uniquely 
identifies each byte of the megabyte address space. The same physical address 
can have many different logical addresses. 

A logical address consists of a segment base value and an offset value. 
For any memory location, the segment base value identifies the first byte of a 
segment containing the location, and the offset value is the number of bytes 
from the beginning of the segment to the location. The lowest-addressed byte 
in a segment has an offset of 0. 

As stored in memory or registers, base and offset values are unsigned 
16-bit quantities. In order to represent physical addresses up to 1MB, 
however, 20 bits are required. Since segments start on 16-byte boundaries, 
each segment base address is a 20-bit number, with zero in the four low-order 
bits. In order to refer to a segment base address by means of a 16-bit word, 
the value of the word represents the uppermost 16 bits of the 20-bit base 
address. That is, the segment base address is equal to the value in a segment 
base register shifted to the left by four binary positions. For example, if 
ES contains the value 6789H, then ES points to the segment starting at 
physical Address 67890H. 

A physical address is derived from a base:offset pair by adding the 
16-bit offset to the contents of a segment register shifted to the left by 
four positions. Refer to Figure 5-6. The resulting 20-bit quantity uniquely 
identifies a location in physical memory. 
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Figure 5-6. Logical to Physical Address Generation 


- v, Log ^ al addr esses allow you to develop programs without prior knowledae 

rnLlapm 6 * he system wU1 locate the code in memory. This facilitates dynamic 
management of memory resources. In order to be dynamically relocatable a 

LrecMvTf T ° r alt6r itS Se9n,ent re 9^ers *nd ">ust not transfer 

offsetsMnMh l0catl0n outslde the current code segment. In other words, all 
segment regSters^ 9 ^ "' U r * latiVe to fixed values contained in the 
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5.3 DOS TECHNICAL INFORMATION 


This section provides a technical overview of the Wang PC DOS, including the^^ 
Wang Menu Driver, the DOS Command Processor, and their use of system resources 


5.3.1 The Contents of a System Start-up Disk 


A system disk must contain the following items in order to load and use the 
Wang PC system menus: 

• Start-up sector—The first sector on all disks formatted with the 
FORMAT command. The FORMAT command puts this sector on all disks in 
order to begin execution of the operating system. 

• File Allocation Tables (FATs) 

• Disk Directory 

• BIOS.SYS, the basic I/O system—The hardware-dependent code that 
handles all hardware interrupts and performs all I/O for the 
operating system 

• MSDOS.SYS, the operating system nucleus—A high-level user-program 
interface that contains data and file handling routines and many 
functions readily accessed by user programs 

• CONFIG.SYS, a system configuration file 

• MENUDRVR.COM, the initialization and resident code for the system 
menus 

• MENU.COM, the menu displayer and processing program 

• MENU.MSG, a message file used by MENU.COM 

• UTILITY.MSG, a message file used by MENU.COM 

• MENU.DAT, the menu data file initially loaded 

In order to load and use THE DOS Command Processor, a disk must also 
contain COMMAND.COM and need not contain MENUDRVR.COM, MENU.COM, MENU.MSG, and 
MENU.DAT. 

Figure 5-7 shows the relationship between BIOS.SYS, MSDOS.SYS, 
MENUDRVR.COM or COMMAND.COM, and system resources. 
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Figure 5-7. DOS and Its Resources 


5.3.2 System Initialization 


When you start or restart the system, the Wang PC’s initialization code reads 
the start-up sector, loads the start-up code into upper memory, and gives it 
control. The start-up code reads the disk directory to ensure BIOS.SYS and 
MSDOS.SYS are on the disk. If they are not on the disk, it displays an error 
message. If the start-up program finds these files, it loads them and gives 
BIOS.SYS control. MSDOS.SYS occupies the first available memory after 
BIOS.SYS. BIOS.SYS and MSDOS.SYS can appear anywhere on the disk. 


System Architecture, Operating System, and File Management 





5-IG 


The beginning of BIOS.SYS has a long call to its initialization code, 
BIC3INIT. BIOSINIT is located at the high end of BIOS.SYS. A variety of BIO 
initializations are done. Then BIOS.SYS makes a long jump to the SYSINIT 
ro-tine. 

The SYSINIT routine initializes the DOS using the specifications in 
-rrFIG.SYS. SYSINIT creates a Program Segment Header (PSH) at the lowest 
sible segment for the program specified in the SHELL = command of 
FIG.SYS. As shipped by Wang, that program is MENUDRVR.COM. COMMAND.COM 
also function as the shell. Then SYSINIT gives control to the shell. 

The following is the list of commands for the file CONFIG.SYS. The 
commands can appear in any order. The list gives Wang-specified values 
vr.srever they differ from the defaults. 

BUFFERS = <number> Specifies the number of buffers in the 

system list. Each buffer uses 528 bytes of 
memory. The maximum number of buffers is 
99. The default number is 2. If CONFIG.SYS 
contains several BUFFERS commands, the value 
in the last command specifies the number of 
buffers. 


FILES = <number> 


DEVICE = <filespec> 


BREAK = <0N or 0FF> 


SWITCHAR = <char> 


The number of open files that the XENIX 
system calls can access. The default is 5. 

A number less than or equal to 5 is 
ignored. The maximum number is 20. Any 
greater number is taken as 20. As shipped 
by Wang Laboratories, the value of FILES is 
set to 10. 

Causes the installation of the device driver 
in <filespec> into the system list. 

If ON is specified (the default is OFF), a 
check for CONTROL + C at the console input 
takes place every time control returns to 
DOS. As shipped by Wang Laboratories, ON is 
specified. 

Causes Function Call 37H to return <char> as 
the current switch designator. The default 
is As shipped by Wang Laboratories, 

the switch designator is . 


AVAILDEV = <TRUE or FALSE> TRUE, the default, means that you can 

reference a device by the reserved name 
<dev> or by /dev/<dev>. FALSE means that 
only /dev/<dev> refers to the device and 
<dev> by itself refers to a file of that 
name in the current directory. 
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SHELL = <filespec> Begins execution of the shell (top-level 

command processor) from the last entry in 
<filespec>. As shipped by Wang 
Laboratories, the default is MEMUDRVR.COM. 

If you specify COMMAND.COM, the menus are* 
not loaded and the DOS Command Processor 
becomes t!’s shell. 

A typical set of CONFIG.SYS commands would be as follows: 

BUFFERS =10 
FILES = 10 
DRIVER - network 
BREAK = ON 

SHELL = /menudrvr.com -nOOl -p/bin 

There are four switches specifiable when the command processor specified 
by SHELL = is MENUDRVR.COM. f ■*. iea 

• -n###, which sets a 3-digit country code for the default values 
established at system start-up. If this switch is not specified, 
the system uses the default code of 001, United States. Refer to 
the SET NATIONAL DEFAULTS system utility in The Wana Professional 
Computer Utility Programs User Guide for a complete discussion of 
country codes and the values they specify. 

• -p<pathname>[;<pathname>;...], which sets the default alternate 
paths. If this switch is not specified, the system uses the default 
pathnames / and /bin. 

• -t, which specifies temporary loading of MENUDRVR.COM, allowing it 
to be cancelled and overwritten. Do not use this switch if you want 
MENUDRVR.COM to be the permanent shell. 

• -h or -hi, which installs the code for printing the contents of the 
screen (using 2ND + PRINT) from any application, -h prints the 
WISCII I characters from 20H to 80H, replacing other characters with 
asterisks, -hi prints the WISCII I characters from 20H to FFH. 

When the program specified in the SHELL = command is C0MMAND.COM, you 
can use the following switches: 

• -p, which specifies that C0MMAND.COM is to be permanent; otherwise, 
C0MMAND.COM can be overwritten later. 

• -c, which specifies that C0MMAND.COM executes one command and then 
terminates. Do not use this switch if you want C0MMAND.COM to be 
the permanent shell. 

• -d, which specifies that C0MMAND.COM does not prompt for date and 
time. 

CONFIG.SYS is an ASCII text file with each line ending with a carriage 
return and linefeed. You can edit CONFIG.SYS using the Wang PC Editor. 
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WARNING: ^ . . . . 

If you modify CONFIG.SYS, be very careful. If you make a mistake, 
v e able to start your system. Always keep backups of the complete 
system disks, including the original CONFIG.SYS. 


you may no^ 
original 


f .3.3 M ENUDRVR.COM 


^NUDRVR.COM is located in memory immediately after MSDOS.SYS and its data 
rea. MENUDRVR.COM has two sections of code, an initialization section and a 
9 sident section. 


nitialization Section 

ne initialization code executes only once. It is overwritten before any 
-her program is executed. This code processes any parameters passed in the 
-HELL = command in CONFIG.SYS and loads the code for the screen print option, 
selected. The initialization code also builds an environment including an 
iiciz string with the list of alternate pathnames specified by the -p switch. 
T* ne resident section passes this environment to any program it loads and 
Ixecutes The initialization code also sets Offset 16H in MENUDRVR.COM' s PSH, 
the parent ID, to MENUDRVR’s PSH segment address. 


Resident Section 

The resident code loads and executes all programs invoked from the menus. 

When you select a program from a menu, MENU.COM, which displays and processes 
the menus, terminates. MENUDRVR.COM stores the current menu and menu 
selection, as well as previous menus and selections. Then it loads and 
executes the selected program. When that program terminates, control returns 
to MENUDRVR.COM. MENUDRVR.COM then invokes MENU.COM to display the last 
processed menu. If MENU.COM is not on the default drive, MENUDRVR.COM prompts 
you for it. 

The resident section of MENUDRVR.COM does all standard disk error 
handling, including displaying error messages and interpreting the response to 
the Abort or Retry prompt. This section also contains code to support screen 
printing, if selected. 

MENUDRVR.COM contains routines to process Interrupts 22H (terminate), 
23H (Control + C or SHIFT + CANCEL), 24H(fatal error abort), 28H (MSD0S 
nonbusy, used for screen print), and FFH (communication vector used by 
MENU.COM and other programs to communicate with the resident section of 
KENUDRVR.COM). 


NOTE: 

Interrupts 28H and FFH may not a 


lways be supported and should not be used. 
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5.3.4 The DOS Command Processor 




■he DOS Command Processor (COMMAND.COM) consists of three sections occupying 

fnrt fT P ° r i° nS ° f meroory: a resident section, an initialization section, 
and a transient section. ' 

Th ® resident section is located in mercery immediately after MSDOS.SYS 
and its data area. This section has routines co process Interrupts 22H 
(terminate) 23H (CONTROL + C or SHIFT + CANCEL). 24H (fatal error abort), and 
27H (terminate but stay resident), as well as code to reload the transient 
c ion. This section of COMMAND.COM also does all standard disk error 

£he 1 "= 1Udin9 d i Splayin ^ error messages and interpreting the response to 

the Abort, Retry, or Ignore prompt. ^ 

h „ A f te f resident section, there follows an initialization section that 
Jh! « tr °i d “ rin 9 system start-up. This section determines the address of 
r Pr09r f mS are l0aded - The first that COMMAND.COM 

ieedd 6XeCUteS ° verlays the initialization section, which is no longer 


hiah * hereis a transient section that is loaded in memory at the 

9 . e transient section is the Command Processor itself, with 

LT™° rS f fOC V™ inte ^ nal cornma nds and batch files, and a routine to load 
•nd run external commands. (External commands are programs with the file 
ame extensions .COM or .EXE.) This section of C0MMAND.COM displays the DOS 
prompt, reads a command from the terminal or batch file, and executes the 
Kommand. It creates a PSH for external commands immediately after the 

°f C0MMAND - C0M ' loads the external command program into this 
segment, sets the terminate and SHIFT + CANCEL interrupt addresses to point to 

tel loaded?' SeCti °" ° f C0MMAND ’ C0M ' and then passes control to the pr^ram it 


that r,3.ri! ranS i ent r« e fu 10n 1S reloaded u P° n the termination of any program 
dXk or if th. J overlaid P art COMMAND.COM is not availabl^on 
section f reSldent sec tion of C0MMAND.COM finds an incorrect transient 

dSwit'H a ."' esSage a P?f ars requesting you to insert a C0MMAND.COM disk in the 
default drive and strike any key when ready. 


5.3.5 DOS Memory Usage 


Figure 5-8 shows a typical map of 
addresses are physical addresses 


memory while MSDOS.SYS is running. All 
in the form NNNNNH (H indicates hexadecimal). 
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Address 


Contents 


FFFFFH 

FC000H 

FBFFFH 

E0000H 

DFFFFH 


XXXZOH 

XXXYFH 


XXXXOH 

XXXWFH 


XXXVOH 

XXXUFH 

00400H 

003FFH 


OOOOOH 


Diagnostic and start-up PROM. 


Video memory (usually deselected). 


Maximum limit of available memory with a memory expansion card. 

If COMMAND.COM is the shell, its transient portion, containing 
the command processor, occupies the highest available part of 
memory. If MENUDRVR.COM is the shell, this section is 
available for user programs. 

All user programs are loaded after the resident portion of 
MENUDRVR.COM or COMMAND.COM. 


The resident section of MENUDRVR.COM if it is the shell. This 
section contains code for handling Interrupts 22H, 23H, 24H, 
28H, and FFH, code for loading programs and logging the menus 
and programs loaded, and, optionally, code for screen prints. 

The resident section of COMMAND.COM if it is the shell. This 
section contains code for handling Interrupts 22H, 23H, 24H, 
and 27H, as well as code for loading programs and reloading 
the transient section of COMMAND.COM, 


MSDOS.SYS. 


BIOS.SYS. 


Interrupt Vectors that contain segment:offset pairs indicating 
the address of an interrupt service routine. These vectors 
are defined in Table 1. Initially, all interrupt vectors 
invoke an error message routine indicating that an undefined 
interrupt has been used. 


Figure 5-8. DOS Memory Usage 


System Architecture, Operating System, and File Management 


5-15 


Table 5 1 lists the definitions of the interrupt vectors in low memory. 


Table 5-1. Interrupt Vectors 


Address 

Usage 

COH - FFH 

Reserved for user programs 

80H - BFH 

Reserved for the BIOS 

40H - 7FH 

Not defined 

20H - 3FH 

Reserved for the operating system 

14H - 1FH 

Reserved for the Intel 8087 emulator 

05H - 13H 

Reserved by Intel 

05H 

Dedicated - Overflow interrupt 

03H 

Dedicated - 1-byte INT instruction 

02H 

Dedicated - Nonmaskable interrupt 

01H 

Dedicated - Single-step interrupt 

OOH 

Dedicated - Divide error interrupt 


5.3.6 Program Initialization 


When the shell, MENUDRVR.COM or COMMAND.COM, 
locates the program at the lowest available 
IRVR.COM or above COMMAND.COM's resident 


^^^locat 
M KNUD 


loads and executes a program, it 
memory segment, immediately above 
section. The shell creates the 


The PSH stores an INT 20 instruction at Offset 0. The PSH also stores 
the addresses for the terminate and SHIFT + CANCEL interrupts. When 
finished, the program returns control to the shell by a jump to Offset 0, by 
issuing an INT 20, by issuing an INT 21 with the AH register set to 0, or by 
using Function Call 4CH. 1 


Each of these methods results in control being passed to the program 
that issued the Load and Execute function call (4BH) by an INT 20 
instruction. MSDOS.SYS restores the terminate and SHIFT + CANCEL exit 
addresses from the PSH. It then passes control to the terminate address. If 
this is a program returning to COMMAND.COM, control transfers to its resident 
Then ' if a batch file was in progress, it continues. Otherwise, 
COMMAND.COM performs a checksum to see if its transient section must be 
reloaded and reloads it, if necessary. The transient section displays the DOS 
prompt and awaits another command from the keyboard. If this is a program 
returning to MENUDRVR.COM, control transfers to its resident portion, which 
loads and executes MENU.COM. The last processed menu then appears. 



NOTE: 

When ending via INT 20 or INT 21, Function OOh, the program must set the CS 
^register to the segment of the PSH. 

The following is the format of the PSH, defined as an Assembly language 
structure. Offsets are in hex. 
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Offset PSH Structure 



PSH 

STRUC 



0 

psh_exit_call 

DW 

7 


Int 20 call 

2 

psh_block_len 

DW 

7 


memory size in paragraphs 


reservedl 

DB 

7 


reserved 

6 

psh_seg_size 

DW 

7 


number bytes available in the 






segment 


reserved _2 

DW 

7 


reserved 

A 

psh_exit 

DD 

7 


terminate address 

E 

psh_control_c 

DD 

7 


control + c address 

12 

psh fatal_abort 

DD 

7 


fatal error handler address 

16 

psh_parent_pid 

DW 

7 


segment address of parent 


reserved_3 

DB 

20 

dup (?) 

reserved _ 

2C 

psh_environ 

DW 

7 


segment address of environment 


reserved^ 

DB 

39 

dup (?) 

reserved 

SC 

psh_fcbl 

DB 

16 

dup (?) 

parameter area formatted as an 






unopened fcb. 

6 C 

psh_fcb 2 

DB 

16 

dup (?) 

parameter area formatted as an 






unopened fcb. 


reserved_5 

DB 

4 

dup (?) 

reserved 

30 

pshjparameters 

DB 

128 dup (?) 

unformatted parameter area and 






default disk transfer address 


The following conditions hold when control passes to any program: 

• If the drive designation of the first or second parameter was 
invalid, the AL or AH register contains FFH, respectively. 

Otherwise, they contain 00H. 

• The word at Offset 6 has the number of bytes available in the 
segment. 

• The word at Offset 2 has the total number of paragraphs in memory. 

• The contents of the File Control Blocks (FCBs) at 5CH and 6 CH are 
defined from the first two parameters of the command that invoked 
the program. 

• The default Disk Transfer Address (DTA) is the 128 bytes beginning 
at 8 OH in the PSH. The byte at 80H contains the number of 
characters, including leading and embedded separators, following 
the command key word. Beginning at 81H is an unformatted 
parameter area containing the characters themselves. 

A .COM program is a direct memory image, including space for 
unintialized data. The entire program must be loaded into one segment of 
memory. Therefore, .COM programs must be no greater than 64KB. The following 
conditions hold when control passes to a .COM program: 
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• The four segment registers have the segment of the PSH. 

• The Instruction Pointer (IP) contains 100H. 


The Stack Pointer (SP) contains the end of the program's segment or 
of the transient section of COMMAND.COM, whichever is lower To' 
ailow for a stack of 100H, the value at Offset 6 is reduced'bv that 


• A word of zeros is pushed on the stack. 

PVP „ ,EXE program ® are out P ut the Linker with relocatable addresses 

.EXE programs may be greater than 64KB. The Linker creates a 28-byte header 
and a relocation table of up to 200H bytes for each .EXE program. SIdSssJs 
uses the information in the header to set up the registers Seating the S 
program. The following listing is the format of of an .EXE file header 
defined as an assembly language structure. Offsets are in hex. 


Offset 

EXE File Header 

Structure 

0 

2 

EXE_file_header 
exe_signature 
exe_len_mod 512 

STRUC 
DW ? 
DW ? 

4 

exe_pages 

DW ? 

6 

exe_rle_count 

DW ? 

8 

exe_par_dir 

DW ? 

A 

exe_min_BSS 

DW ? 

C 

exe_max_BSS 

DW ? 

E 

exeSS 

DW ? 

10 

exeSP 

DW ? 

12 

exe_chksum 

DW ? 


; must contain M ZM" (5A4DH) 

; number of bytes contained in 
; the last page (low 9 bits of 
; length) 

; number of 512—byte pages 
; in the file including the 
; header 

; number of entries in the 
; relocation table 
; number of 16-byte paragraphs 
; in the header 

; minimum number of paragraphs 
; required above the end of the 
; loaded program (for Version 
; 2.0 and above of the DOS) 

; maximum number of paragraphs 
; required above the end of the 
' program. OFFFFH indicates the 
; program is located as low as 
; possible 

, initial value to be loaded into 
; SS before execution. 

; Relocation must adjust this 
; value. 

; initial value to be loaded 
; into SP before execution 
; negative of the sum of all the 
; words in the run file 
; (presently ignored) 
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Offset EXE File Header Structure 
14 exe_IP DW ? 

16 exe_CS DW ? 

18 exe_rle_table DW ? 

1A exe_iov DW ? 

EXE fileheader ENDS 


initial offset to be loaded 
into IP before execution 
initial value to be loaded into 
CS before execution. 

Relocation must adjust this 
value. 

relative byte offset of the 
relocation table from the 
beginning of the run file. 

This should be 01CH. 
number of the overlay. The 
resident part of the program 
will have iov = 0. 


The relocation table follows the fixed portion of the run file 
header. The entries in the relocation table are 4-byte pointers to words 
in the run file to which a relocation factor is to be added. The 
relocation factor is the physical address of the first byte of the 
resident portion divided by 16. The relocation factor must first be 
added to the first word of each table entry before the table entry points 
to the actual location of the word. 

The resident portion begins at the first 512-byte boundary 
following the end of the relocation table. If there is no relocation, 
the resident portion begins immediately after the header. The layout of 
the entire run file, with relocation table, is as follows: 


28-Byte Header 
Relocation table 
Padding (less than 200H bytes) 
Memory image 


512-byte boundary 


512-byte boundary 


The following conditions hold when control passes to an .EXE 
program: 

• DS and ES registers have the segment address of the PSH. 

• CS, IP, SS, and SP registers contain values set by the Linker. 
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5.3.7 Disk Error Handling 


ienever a disk read or write error occurs or the FAT is bad, DOS transfers 
control to the error handler by an INT 24H (fatal error) instruction 
COMMAND.COM contains the default error handler. To use your own error handler 

nnc UPt 24H vector to the addressrof your code by using Function 
Call 25H. DOS gives you error information through the registers and supports 
Abort, Retry, or Ignore through return codes. 

When it gives control to a program, DOS. does not save the original 
contents of the fatal error address. If you change this interrupt address 
your program must first save its original contents and then restore them 
before terminating. 


5.4 FILE AND DISK MANAGEMENT 



DOS supplies ways (through Interrupt 21H) to create, rename, read, write, and 
delete files. File handling uses two areas of memory and four areas of disk 
space. The memory areas are the File Control Block (FCB), which can be 
preceded by an Extended File Control Block, and the DTA. The disk space areas 
re the reserved start-up sector, the Disk Directory, the FAT, and the file 
section. The next subsection describes memory management for files The 
following subsections describe disk management. 


4.1 File Control Block Definition 


This subsection describes the DOS FCB and Extended FCB. Any reference in the 
description of DOS function calls (Section 5.3) to an FCB, whether opened or 
unopened, can use either a normal FCB or an extended FCB. However, only 
programs written for pre-2.0 versions of MSDOS need to use the FCBs. 


The DOS File Control Block 


The DOS File Control Block is formatted as follows: 
lZte Description 

0 Drive indicator. 0 = the default drive, 1 = Drive A, 2 

- Drive B, etc. The maximum number of drives is 64. 

1-8 File name - If the file is less than eight characters, 

the name must be left justified with trailing blanks. 
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Byte 

9-11 

12-13 

14-15 

16-19 

20-21 


22-23 

24 

25-26 


Description 

Extension to file name. If less than three characters, 
the extension must be left justified with trailing 
blanks (20H). It can also be all blanks. 

Current block. This word (low byte first) specifies the 
current block of 128 records, relative to the start of 
the file, in which sequential disk reads and writes 
occur. Zero indicates the first block of the file; one 
indicates the second, etc. Combined with the current 
record field (Byte 32), these bytes identify a 
particular logical record. 

Size of the record you want to work with. You fill this 
word immediately after an Open of the file, if you do 
not want the default logical record size (128 bytes). 

The Open and Create functions set this field to 128. An 
attempt to read or write with the field set to zero also 
changes it to 128. 

File size. Current size, in bytes, of the file. User 
programs can read this field but must not write it. 

Date of creation or last write. All creates and writes 
set this field to the current date. Opens set it to the 
date recorded in the file's directory. To change the 
date recorded in the file’s directory, user programs can 
modify this field after writing to, but before closing, 
a file. 

The format of this 16-bit field is as follows: Bits 
0-4, day of month; Bits 5-8, month of year; Bits 9-15, 
year minus 1980. All zeros mean no date. 

Time of creation or last write. This field is updated 
in the same way as the Date field. Bytes 20-21. The 
format is as follows: Bits 0-4, seconds/2; Bits 5-10, 
minutes; Bits 11-15, hours. 

Flags. Bit 7 is set to 0 for a file, 1 for a device. 

Bit 6 is set to 0 if there are changes that have not 
been written. Bits 0 to 5 contain the device ID. 

Disk address of the first allocation unit in the file. 
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Description 

Disk address of the last allocation unit in the file. 

Disk addresses of the allocation unit last accessed and 
the directory of the file. These are 12-bit addresses 
occupying 1.5 bytes each. 

Current record. Points to one of the 128 records in the 
current block. This field and the Current Block field 
.(Bytes 12 and' 13) make up the record pointer. The Open 
File system call does not initialize this field. You must 
set it before doing a sequential read or write to the file. 

Relative record. Points to the currently selected record, 
counting from the beginning of the file (starting with 
0). The Open File system call does not initialize this 
field. You must set it before doing a random read or 
write to the file. If the record size is less than 64 
bytes, both words of this field are used; if the record 
size is 64 bytes or more, only the first three bytes are 
used. 

Figure 5-9 shows the layout of the FCB and the extended FCB. 


Byte 

27-28 

29-31 

32 


-07H 



FFH 

Zeros 

Attribute 


File (8 bytes) or Reserved de 

ivice name 


File name extension 
- !-—- 

Current block 

Record size 


18H 

20H 


File size 
(low part) 


Flags 


File size 
(high part) 


Date 


Allocation units and Directory 


Current Relative record 
record number (low part) 


Relative record 
number (high part) 


Time 


FCB 

extension 

FCB 


Figure 5-9. File Control Block 
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The Extended File Control Block 


The extended FCB is a special format used to search directories for files 
excluded from normal searches (system files and hidden files). Consisting of 
the seven bytes in front of a normal FCB, the format of the extended FCB is as 
follows: 


FCB - 7 


Flag. FF hex placed here signals an extended FCB. 


FCB - 6 to Zero field. 

FCB - 2 

FCB _ i Attribute byte. If Bit 1=1, directory searches 

include hidden files. If Bit 2=1, directory searches 
include system files. 


5.4.2 The Disk Transfer Address 


The DTA is the memory area that contains the data for disk reads and writes. 
The DTA can be at any location. Your program sets the DTA by using Function 
Call 1AH. 

A program can have only one DTA in effect at one time. The program must 
set the DTA before doing any disk I/O. Once defined, a DTA remains in effect 
for all disk operations until the program declares a new DTA by issuing 
another 1A function call. When it transfers control to a program, 

COMMAND.COM builds a default DTA for 128 bytes at 80H into the PSH. 


5.4.3 Diskette Layouts 


The Wang PC BIOS supports eight diskette formats, four formats with 512-byte 
sectors and four formats with 256—byte sectors. This section lists the 
specifications, together with the contents of the start-up sector, for each 
format. Where the specifications differ for 512- and 256-byte sectors, the 
value for for 512-byte sectors appears first, and the value for 256-byte 
sectors follows immediately in parentheses. 
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Single-Sided, Double-Density (8 sectors per track) 

512 (256) bytes per sector 
320 (640) sectors per diskette 
163840 bytes per diskette 
FAT ID Byte =0FEH (OFAH) 

2 FATS 

1 (2) sector per FAT 

1 ( 2 ) sector per allocation unit 
64 disk directory entries 

32 bytes per disk directory entry 
Sector 0 (0-1) = Boot Sector 

Sector 1 (2-3) = File Allocation Table (Copy 1 ) 

Sector 2 (4-5) = File Allocation Table (Copy 2 ) 

- Sectors 3 through 6 (6 through 13) = Disk Directory 

Sectors 7 through 319 (14 through 639) = Data Area, unreserved 
160256 bytes 

Single-Sided, Double-Density (9 sectors per track) 

512 (256) bytes per sector 
360 (720) sectors per diskette 
184320 bytes per diskette 
FAT ID Byte = 0FCH (0F8H) 

2 FATS 

2 (4) sectors per FAT 

1 ( 2 ) sector per allocation unit 
64 disk directory entries 

32 bytes per disk directory entry 
Sector 0 (0-1) = Boot Sector 

Sectors 1 through 2 (2 through 5) = File Allocation Table (Copy 1 ) 

Sectors 3 through 4 (6 through 9) = File Allocation Table (Copy 2) 

Sectors 5 through 8 (10 through 17) = Disk Directory 

Sectors 9 through 359 (18 through 359) = Data Area, unreserved, 

179712 bytes 

Double-Sided, Double-Density (8 sectors per track) 

512 (256) bytes per sector 
640 (1280) sectors per diskette 
327680 bytes per diskette 
FAT ID byte = 0FFH (0FBH) 

2 FATS 

1 (2) sector per FAT 

2 (4) sectors per allocation unit 
112 disk directory entries 

32 bytes per disk directory entry 
Sector 0 (0-1) = Boot Sector 

Sector 1 (2-3) = File Allocation Table (Copy 1 ) 

Sector 2 (4-5) = File Allocation Table (Copy 2) 

Sectors 3 through 9 (6 through 19) = Disk Directory 

Sectors 10 through 639 (14 through 1179) = Data Area, unreserved, 

322560 bytes 
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jouble-Sided, Double-Density (9 sectors per track) 

512 (256) bytes per sector 
720 (1140) sectors per diskette 
368640 bytes per diskette 
FAT ID byte = OFDH (0F9H) 

2 FATS 

2 (4) sectors per FAT 
2 (4) sectors per allocation unit 
112 disk directory entries 
32 bytes per disk directory entry 
Sector 0 (0-1) = Boot Sector 

Sectors 1 through 2 (2 through 5) = File Allocation Table (Copy 1) 

Sectors 3 through 4 (6 through 9) = File Allocation Table (Copy 2) 

Sectors 5 through 11 (10 through 23) = Disk Directory 
Sectors 12 through 719 (24 through 1139) = Data Area, unreserved, 
362496 bytes 


: ie Start-up Sector 

Figure 5-10 shows the BIOS Parameter Block variables that the start-up sector 
contains for the diskette format with 512-byte sectors. Figure 5-11 gives the 
same information for formats with 256-byte sectors. Figure 5-12 presents this 
information for the 10-megabyte, 30-megabyte, and partitioned Winchester 
disks. The BIOS Parameter Block begins at Offset 0BH of the start-up sector. 
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TYPE 

DESCRIPTION 

SSDD/8 

SSDD/9 

DSDD/8 

DSDD/9 

WORD 

BYTES PER SECTOR 

512 

512 

512 

512 



:(200H) 

(200H) 

(200H) 

(200H) 

BYTE 

SECTORS PER ALLOCATION UNIT 

1 

1 

2 

2 

WORD 

RESERVED SECTORS 

(NUMBER REQUIRED BY START-UP) 

1 

1 

1 

1 

BYTE 

NUMBER OF FATS 

2 

2 

2 

2 

WORD 

NUMBER OF ROOT DIR ENTRIES 

64 
< 40H) 

64 

(40H) 

112 
(70H) 

112 

(70H) 

WORD 

NUMBER OF SECTORS/LOGICAL IMAGE 

320 

360 

640 

720 


(i.e., NUMBER OF SECTORS/FLOPPY) 

(140H) 
BYTES= 
163840 

(168H) 
BYTES= 
184320 

(280H) 

BYTES= 

327680 

(2D0H) 
BYTES= 
368640 

BYTE 

MEDIA DESCRIPTOR 
(i.e., FATID) 

OFEH 

0FCH 

0FFH 

0FDH 

WORD 

NUMBER OF SECTORS PER FAT 

1 

2 

1 

2 

WORD 

SECTORS PER TRACK 

8 

9 

8 

9 

WORD 

NUMBER OF HEADS 

1 

1 

2 

2 

WORD 

NUMBER OF HIDDEN SECTORS 

0 

0 

0 

0 

WORD 

NUMBER OF SECTORS RESERVED FOR 

7 

9 

10 

12 


START-UP + FATS + DIRECTORY 

(07H) 

(09H) 

(0AH) 

(OCH) 


Figure 5-10. Start-up Sector BIOS Parameter Block Variables (512-byte Sector 
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TYPE 

DESCRIPTION 

SSDD/16 

SSDD/18 

DSDD/16 

DSDD/18 Jj 
. 







WORD 

BYTES PER SECTOR 

256 

(100H) 

256 

(100H) 

256 

(100H) 

256 

(100H) 

BYTE 

SECTORS PER ALLOCATION UNIT 

2 

2 

4 

4 

WORD 

RESERVED SECTORS 

(NUMBER REQUIRED BY START-UP) 

2 

2 

2 

2 

BYTE 

NUMBER OF FATS 

2 

2 

2 

2 

WORD 

NUMBER OF ROOT DIR ENTRIES 

64 

(40H) 

64 
(40H) 

112 
(7 OH) 

112 
(70H) 

WORD 

NUMBER OF SECTORS/LOGICAL IMAGE 

640 

720 

1280 

1440 


(i.e. , NUMBER OF SECTORS/FLOPPY) 

(280H) 
BYTES= 
163840 

(2D0H) 
BYTES= 
184320 

(500H) 
i BYTES= 

1 327680 

(5A0H) 
BYTES= 
i 368640 

BYTE 

MEDIA DESCRIPTOR 
(i.e., FATID) 

OFAH 

0F8H 

0FBH 

0F9H 

WORD 

NUMBER OF SECTORS PER FAT 

2 

4 

2 

4 1 

WORD 

SECTORS PER TRACK 

16 

18 

16 

18 

WORD 

NUMBER OF HEADS 

1 

1 

2 

2 

WORD 

NUMBER OF HIDDEN SECTORS 

0 

0 

0 

0 

WORD 

NUMBER OF SECTORS RESERVED FOR 

14 

18 

20 

24 


START-UP + FATS + DIRECTORY 

(OEH) 

(12H) 

(14H) 

(18H) 


Figure 5-11. Start-up Sector BIOS Parameter Block Variables (256-byte Sectors) 


System Architecture, Operating System, and File Management 



5-27 


TYPE 

DESCRIPTION 

10 Meg 

30 Meg 

Partitioned 

r 

WORD 

BYTES PER SECTOR 

512 

(200H) 

512 

(200H) 

Same* 

BYTE 

1 

SECTORS PER ALLOCATION UNIT 

8 

16 

Changes with size 
of partition 

WORD 

RESERVED SECTORS 

(NUMBER REQUIRED BY START-UP) 

1 

1 

Same* 

BYTE 

NUMBER OF FATS 

2 

2 

Same* 

WORD 

NUMBER OF ROOT DIR ENTRIES 

128 

128 

Same* 

WORD 

NUMBER OF SECTORS/LOGICAL IMAGE 

19456 
(4C00H) 

65280 

(FF00H) 

Changes with size 
of partition 

BYTE 

\l—j 

MEDIA DESCRIPTOR 
(i.e., FATID) 

F9H 

F9H 

Same* 

WORD 

NUMBER OF SECTORS PER FAT 

8 

12 

Changes with size 
of partition 

WORD 

SECTORS PER TRACK 

16 

16 

Same* 

WORD 

NUMBER OF HEADS 

4 

8 

Changes with 
Winchester type 

WORD 

number of hidden sectors 

0 

0 

Changes with size 
of FATs 

WORD 

number of sectors reserved for 

START-UP + FATS + DIRECTORY 

25 

(19H) 

33 

(21H) 

Total of numbers 
from above 
entries 


*Same indicates that value is equal to value for nonpartitioned disk 


(Figure 5-12. Start-up Sector BIOS Parameter Block Variables (Winchester Disk) 
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5.4.4 Disk Space Allocation 

DOS disk space is divided into four parts. 

• Start-up Sector. This region contains the DOS start-up code. 

• File Allocation Table. The FAT contains location information for 
the data making up each file on a given disk. 

• Disk Directory. The directory contains information about each file 
on a given disk. This information includes the file's complete file 
name, its size, its attributes, the time and date of its last 
modification, and the location on disk of its first sector. 

• The File Section. The great majority of disk space is reserved for 
the contents of files. 

An individual file does not necessarily reside in contiguous sectors on 
disk, and may be scattered to decrease waste of disk space. Through the 
chaining of file sectors, using the FAT and the fields specified in the FCB, 
you can access a file either sequentially or randomly. You can access records 
sequentially by using the sequential read or write function calls together 
with the current block and record fields of the FCB. You can access records 
randomly by using the random read or write function calls and the random 
record fields. Also, the random block functions allow reading or writing 
large amounts of data with one function call. With any of these methods, DOS 
itself calculates the correct locations on the disk. 


5.4.5 The Disk Directory 

The FORMAT command creates a directory on each disk as described previously. 
Directory entries, whether in the disk directory or in subordinate 
directories, are formatted as indicated in Table 5-2. 
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Location 

Bytes 

Description 

00H 

11 

File name and extension 

OBH 

1 

Attributes. Tab!. 5-3 defines the entries 
in this field 

OCH 

10 

Zero-filled field (for expansion) 

16H 

2 

Time of creation or last write 

Bits 0-4 = sec*2 

5-10 = min 

11-15 = hrs 

18H 

2 

Date of creation or last write 

Bits 0-4 = day 

5-10 = month 

11-15 = year 

1AH 

2 

First allocation unit 

1CH 

4 

File size, in bytes 
(30 bits max) 


free. 


I L the J firSt byte of the file name field is E5, the directory entry is 
00 indicates the end of the allocated directory. 


Table 5-3 defines the entries in the attribute byte of a directory. 


Table 5-3. File Attribute Codes 


Byte 

Attribute 

01H 

Read only 

02H 

Hidden file 

04H 

System file 

08H 

Volume ID 

10H 

Directory 

2 OH 

Archive bit 


A flle can have any combination of the read only, hidden file, and 
system file attributes. The volume ID or directory attribute must be the only 
attribute of the file. 
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5.4.6 The File Allocation Table 


DOS uses the FAT to allocate disk space to files, one allocation unit at a 
time A copy of the FAT for the last disk used in each drive is retained in 
internal memory, space permitting. DOS writes the FAT when the status of the 
disk's file section changes. 


The FAT uses a 12-bit (1.5 byte) entry for each allocation unit on the 
disk. FAT entry number zero is used as an end-of-file trap in the DOS and is 
passed to the BIOS to help determine disk format. Entry one is reserved for 
future use. The first available allocation unit is assigned entry two, and 
even though it is the first, it is called allocation unit two. 


Each FAT entry contains three hexadecimal characters. If the allocation 
unit is unused and available, the entry contains 000H. Entries greater than 
FF7H are end-of-file marks. FF7H indicates that the allocation unit has a bad 
sector All other hexadecimal characters are the relative number of the next 
allocation unit in the file. The file's directory entry contains the relative 
allocation unit number of the first sector in the file. 


To obtain a record's logical sector (relative sector, such as that used 
by Interrupts 25H and 26H and by DEBUG), use the directory entry to find the 
starting allocation unit of the file. Convert the allocation unit to a 
logical sector number by the following steps: 


1. Subtract 2 from the allocation unit number. 

2. Multiply the result by the number of sectors per allocation unit 

3. Add to this result the logical sector number of the start of the 
data area. 


Locate each subsequent allocation unit of the file by the following 

steps: 

1. Multiply the allocation unit number last used by 1.5 (each FAT entry 
is 1.5 bytes long). 

2. The whole part of the product is an offset into the FAT, pointing to 
the entry that maps the allocation unit just used. That entry has 
the allocation unit number of the next allocation unit of the file. 

3. Use a MOV instruction to move the word at the calculated FAT offset 
into a register. 

4. If the last allocation unit used was an even number, keep the 
low-order 12 bits of the register by ANDing it with FFF; otherwise, 
keep the high-order 12 bits by shifting the register right 4 bits 
with a SHR instruction. 

5. If the resultant 12 bits are FF8H-FFFH, the file contains no more 
allocation units. Otherwise, the 12 bits contain the allocation 
unit number of the next allocation unit in the file. 
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CHAPTER 6 

DOS INTERRUPTS AND FUNCTION C ALLS 


6.1 INTRODUCTION 


This chapter presents a detailed description of all the DOS interrupts and 
function calls. You should use this information only if you have previous 
experience with assembly language programming and have a thorough knowledge of 
the technical information provided in Chapter 5. The Wang PC Professional 
Network Services provides other function calls for the programmer. Refer to 
The Wang Professional Computer Professional Network Servic es Programmer's 
Reference Guide. ~ “ -- 


6.2 INTERRUPTS 


^)S includes seven interrupts, which are summarized alphabetically and 
numerically in Tables 6-1 and 6-2. This section describes each interrupt in 
detail. DOS reserves Interrupts 28H to 40H for its use. 

To write your own interrupt processing routine, use Function Call 25H 
(Set interrupt vector). Return from the interrupt routine via the IRET 
instruction, which restores all registers and flags. On return from the 
interrupt, be sure to reset the interrupt vector to the original value so that 
it is available for other applications. 


Table 6-1. Alphabetic Summary of DOS Interrupts 


Interrupt 

Value 

Absolute disk read 

25H 

Absolute disk write 

26H 

Fatal error abort vector 

24H 

Function request 

21H 

Program terminate 

2 OH 

SHIFT + CANCEL exit address 

23H 

Terminate address 

22H 

Terminate but stay resident 

27H 
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V alue 

20H 


21H 


22H 


DOS 


Table 6-2. Numeric Summary of DOS Interrupts 


fci occurence] 
000 J : n Fc 
0 

£$30 : 

0000 : 7 * ^ 

; eibe 
; eiez 


Value 

Interrupt 

2 OH 

Program terminate 

21H 

Function request 

22H 

Terminate address 

23H 

SHIFT + CANCEL exit address 

24H 

Fatal error abort vector 

25H 

Absolute disk read 

26H 

Absolute disk write 

27H 

Terminate but stay resident 


Description 
Program terminate 

Ml open file handles are closed, the disk cache is cleaned, and all 
file buffers are flushed to disk. Be sure that all files that have 
changed in length are closed (refer to Function Call 10H) prior to 
issuing this interrupt; otherwise the directory does not list lt: ® 
correct length. When this interrupt executes, CS must point to the 
100H parameter area. A macro for issuing Interrupt 20H follows. 

Macro: terminate macro 

int ^ OH 


endm 


Function request 

AH must contain the number of the system function. See Section 
5.2.2 for full descriptions of system functions. 

Example: mov AH,2CH 

int 21H 


Terminate address 

This interrupt receives the value of the OAH offset to the Program 
Segment Header, which contains the address to which program contro 
returns. 
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24H 


Control + C (or SHIFT + CANCEL) 

Exit Address 

If you enter CONTROL + C (or SHIFT + CANCEL) during keyboard input 
or display output, control shifts to the 23H vector in the interrupt 
table and the address is copied into the Program Segment Header. 
Considerations for the CONTROL + C handier routine are as follows: 

• If the CONTROL + C routine preserves all registers, you can 
use IRET to continue program execution; then the handler 
routine has no restrictions. 

• If Function 09H or OAH (refer to Section 6.3.1) is 
interrupted by CONTROL + C, the 3-byte sequence 03H-0DH-0AH 
is sent to the display and the function resumes at the 
beginning of the next line. 

• If the program creates a new segment and loads a second 
program that changes the CONTROL + C address, termination 
of the second program restores the CONTROL + C address to 
its value before execution of the second program. 

Fatal error abort vector 

A fatal disk error during a disk I/O function call causes transfer 
of control to this interrupt and this address is copied into the 
Program Segment Header when the segment is created. BP:SI contains 
the address of a Device Header Control Block, which contains 
additional retrievable information. This interrupt is not issued 
during a 25H or 26H interrupt. You can develop error-handling 
routines for this interrupt by using the information presented 
below. 

• The error-handling routine can retrieve error codes from the AX 
and DI registers. AH has its Bit 7 = 0 if the error is a hard 
disk error (probably the most common occurrence). Bit 7 = 1 for 
character device errors or for a bad image of the FAT. If tlie 
error is a bad FAT image, the byte high-order bit device header 
passed in BP:SI indicates a block device; otherwise, the error 
is a character device error. A list of error codes follows: 

- 0 Write protect 

- 1 Unknown device 

- 2 Drive not ready 

- 3 Unknown command 

- 4 Data error 

- 5 Bad request structure length 

~ 6 Seek error 

- 7 Unknown media 

- 8 Sector not found 

~ 9 Printer out of paper 

~ A Write fault 

- B Read fault 

- C General disk failure 
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Starting from the top, the user stack looks as follows: 


IP 

CS 

FLAGS 

AX 

BX 

CX 

DX 

SI 

DI 

BP 

DS 

ES 

IP 

CS 

FLAGS 

• If an IRET is executed, DOS responds according to AL as follows: 

- (AL)=0 Ignore the error. 

- (AL)=1 Try the operation again. (IF YOU USE THIS OPTION, 

STACK DS, ES, BX, CX, AND DX MUST NOT BE MODIFIED.) 

- (AL)=2 Abort the program. 

• AL, CX, DX, and DS:BX are set for a retry of the transfer with 

INT 25H or INT 26H. The hardware sets DI to a 16-bit error code. 

• Before entering the error-handling routine, DOS retries the 
operation five times. 

• DOS enters the error-handling routine in a disabled state. 

• You must preserve the SS, SP, DS, ES, BX, CX, and DX registers. 

• Do not use DOS function calls if possible. If you do need to 
use a DOS function call, use only those between 01H and OCH; if 
you use any others, the DOS stack is destroyed and from that 
point on, DOS may not correctly complete the functions. 

• Within the error-handling routine, restore all application 
program registers from the stack, remove all but the last three 
words on the stack, and issue an IRET. 

• Do not use this exit for disk errors occurring during Interrupts 
25H or 26H; use it only for errors occurring during Interrupt 
21H. 
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ICTION CALLS 


function calls require user-supplied input from the registers. Once 
Ni o\l have specified the input, use one of the following three methods to invoke 
4rKe call. 


1. If you are using DOS Version 2.0 or higher, place the function 

number in AH and execute a long call to Offset 50H in your Program 
Segment Header. 


2. For any DOS version, place the function number in AH and issue 
Interrupt 21H. 


3. For programs that used different calling conventions, including CP/M 
calling conventions, place the function number in CL and set the 
other registers according to the function specification. Then, make 
an intrasegment call to Location 5 in the current code segment which 
contains a long call to the DOS function dispatcher. This method 
destroys AX, but otherwise completes the function call. All new 
programs should avoid this technique. This method is valid only for 
Calls 00H through 24H (for CP/M, only for Calls 00H through 24H, 
which do not pass a parameter in AL). 


* 

refute 

# 

prolan 


When DOS assumes control, it switches to an internal stack; user 
±ers, except AX, are preserved, except as indicated in the specific 
The user stack must be sufficient to accommodate the interrupt 
The user stack should be a minimum of 128 bytes in addition to your 
'am's needs. 


Versions of DOS prior to Version 2.0 implement Function Calls 00H to 
2EH. These calls are compatible with Versions 2.0 and above, except in the 
following cases; 


• Programs that use Functions 27H or 28H to point to the FAT will no 
longer work because there is no fixed location in memory for the 
FAT. Functions 27H and 28H still exist, but you can use them only 
to get the FAT ID byte. On return from 27H or 28H, ES:BX points to 
a FAT ID byte for the drive you are using. 


WARNING: 

If you use Function Calls 27H or 28H for anything but reading the ID 
byte, the system crashes. 
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25H 


) 



Absolute disk read 

This interrupt transfers control to the BIOS. AL must contain^^^ 
drive number; DS:BX must contain the Disk Transfer Address; CX must 
contain the number of sectors, and DX must contain the beginning of 
the relative sector. The Disk Transfer Address receives from CX the 
number of sectors read from the disk. You must save any registers 
before issuing this interrupt because it destroys all but the 
segment registers. The system pushes the flags at the time of the 
call and they remain on the stack until return. If disk operation 
was unsucessful, CF is 1 and AL contains the error code (refer to 
error codes listed for Interrupt 24H). Pop the stack upon return to 
avoid excessive growth. A macro for issuing Interrupt 25H follows: 


Macro: abs disk read 


macro disk, buffer, num_sectors, start 

mov AL,disk 

mov BX,offset buffer 

mov CX,num_sectors 

mov DH,start 

int 25H 

endm 


26H 


) 


Absolute disk write 


This interrupt is the counterpart to Interrupt 25H, 
are read rather than written. 


except that. 



27H 


Terminate but stay resident 

Use this interrupt to ensure that a piece of code remains resident 
in the system after its termination. Usually you would use this 
call in .COM files to allow some device-specific interrupt handler 
to remain resident for processing asynchronous interrupts. DX must 
contain the offset (from CS) of the first byte following the last 
byte of code in the program. When this interrupt is executed, the 
program terminates, but COMMAND treats it as an extension of DOS and 
does not overlay it with other programs. For programs using DOS 
versions above 2.0, use Function 31H instead of this interrupt. A 
macro for issuing Interrupt 27H is as follows: 


Macro: stay_resident macro 

mov 

inc 

int 

endm 


last_instruc 

DX,offset last_instruc 

DX 

27H 


) 
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• Some of the Version 2.0 calls duplicate the functions of pre-Versior 
2.0 calls but add new functionality. The additional functionality 
) allows for future upgrades of the operating system. Therefore, you 

should use Version 2.0 calls whenever you can. 


• I/O control with Versions 2.0 and above makes use of a 16-bit file 
handle assigned to the file or device by the system when the file or 
device is opened. Subsequent I/O functions on the file or device 
must refer to the file handle. Function Calls 3CH, 3DH, and 45H 
return the file handle in AX. The following is a list of the 
default file handles. 

0 = standard input device 

1 = standard output device 

2 = standard error message device 

3 = standard auxiliary device 

4 = standard printer 


• Previous to Version 2.0, writes to the screen would use Function 
Call 6 (Direct console I/O). With 2.0 and above, writes to the 
screen should use Function Call 40H (Write a file) with the default 
output file handle (1). 


• Version 2.0 file I/O makes use of directory paths where pre-Version 
2.0 calls use file names and extensions only. Refer to The Wancj 
Professional Computer Utility Programs User Guide for a discussion 
of directory paths. 

The function calls from 39H on are compatible with the XENIX operating 
system. XENIX is a multitasking operating system, and use of these calls 
makes future upgrading to that system possible. All XENIX function calls 
return carry set if an error occurs. 


NOTE: 

Several of the descriptions that follow refer to ASCIZ character strings. An 
ASCIZ string is a series of ASCII characters terminated by OH as the 
end-of-string indicator. 
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For Version 2.0 calls, the AX register receives error codes and return 
alues. The error code definitions are presented in Table 6-3. When the 
ilue in AX could be either an error code or return value, AX has an error 
ode if the Carry Flag is on; otherwise, it has the return value. 


Table 6-3. Error Code Definitions 


Value 

Error 

0 

No error occurred 

1 

Error invalid function 

2 

Error file not found 

3 

Error path not found 

4 

Error too many open files 

5 

Error access denied 

6 

Error invalid handle 

7 

Error memory block bad 

8 

Error not enough memory 

9 

Error invalid block 

A 

Error bad environment (refer to Function Call 4B) 

B 

Error bad format 

C 

Error invalid access 

D 

Error invalid data 

F 

Error invalid drive 

10 

Error current directory 

11 

Error not same device 

12 

Error no more files 
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Table 6-4 presents an alphabetical list of the function calls. Where 
pre-Version 2.0 and Version 2.0 calls have duplicate functions, the list 
indicates to which category the call belongs. 


Table 6-4. DOS Function Calls, Alphabetic Order 


Function Name 

Value 

Allocate memory 

48H 

Auxiliary input 

03H 

Auxiliary output 

04H 

Buffered keyboard input 

OAH 

Change attributes 

43H 

Cha ng e incompatib1e 


configuration parameters 

37H 

Change the current directory 

3BH 

Check keyboard status 

OBH 

Close a file handle (2.0) 

3 EH 

Close file (1.25) 

10H 

CONTROL + C check 

33H 

Create a file (2.0) 

3CH 

Create file (1.25) 

16H 

Create a subdirectory 

39H 

Current disk 

19H 

Delete a directory entry 

41H 

Delete file 

13H 

Direct console input 

07H 

Direct console I/O 

06H 

Disk reset 

ODH 

Display character 

02H 

Display string 

09H 

Duplicate a file handle 

45H 

File size 

23H 

Find first file match 

4 EH 

Find next file match 

4FH 

Flush buffer, read keyboard 

OCH 

Force a duplicate of a handle 

46H 

Free allocated memory 

49H 

Get date 

2 AH 

Get disk free space 

36H 

Get Disk Transfer Address 

2FH 

Get DOS version number 

3 OH 

Get interrupt vector 

35H 

Get time 

2CH 
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Table 6-4. DOS Function Calls, Alphabetic Order (continued) 


Function Name 

Value 

Get/set date/time of file 

57H 

I/O control for devices 

44H 

Keep a process 

31H 

Load and execute a program 

4BH 

Modify allocated memory block 

4AH 

Move a directory entry 

56H 

Move a file pointer 

42H 

Open a file (2.0) 

3DH 

Open file (1.25) 

OFH 

Parse file name 

29H 

Print character 

05H 

Random block read 

27H 

Random block write 

28H 

Random read (1.25) 

21H 

Random write (1.25) 

22H 

Read from a file/device (2.0) 

3FH 

Read keyboard 

08H 

Read keyboard and echo 

01H 

Remove a directory entry 

3 AH 

Rename file (1.25) 

17H 

Retrieve the return code 


of a child process 

4DH 

Return current setting of 


verify flag 

54H 

Return country-dependent 


information 

38H 

Return text of current 


directory 

47H 

Search for the first entry 

11H 

Search for the next entry 

12H 

Select disk 

OEH 

Sequential read (1.25) 

14H 

Sequential write (1.25) 

15H 

Set/check CONTROL + C state 

33H 

Set date 

2BH 

Set Disk Transfer Address 

1AH 

Set relative record 

24H 

Set time 

2DH 

Set vector 

25H 

Set/reset verify flag 

2 EH 

Terminate a process 

4CH 

Terminate program 

00H 

Write to a file/device (2.0) 

40H 
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Table 6-5 presents the function calls numerically. For Version 1.25 
calls that have Version 2.0 duplicates, the duplicates are indicated. 


Table 6-5. DOS Function Calls, Numeric Order 


Value 

r 

Function 

00H 

Terminate program 

01H 

Read keyboard and echo 

02H 

Display character 

03H 

Auxiliary input 

04H 

Auxiliary output 

05H 

Print character 

06H 

Direct console I/O 

07H 

Direct console Input 

08H 

Read keyboard 

09H 

Display string 

OAH 

Buffered keyboard input 

OBH 

Check keyboard status 

OCH 

Flush buffer, read keyboard 

ODH 

Disk reset 

OEH 

Select disk 

OFH (for 2.0, 3DH) 

Open file 

10H (for 2.0, 3EH) 

Close file 

11H 

Search for first entry 

12H 

Search for next entry 

13H 

Delete file 

14H (for 2.0, 3FH) 

Sequential read 

15H (for 2.0, 40H) 

Sequential write 

16H (for 2.0, 3CH) 

Create file 

17H 

Rename file 

19H 

Current disk 

1AH 

Set Disk Transfer Address 

21H 

Random read 

22H 

Random write 

23H 

File size 

24H 

Set relative record 

25H 

Set vector 

27H 

Random block read 

28H 

Random block write 

29H 

Parse file name 

2AH 

Get date 

2BH 

Set date 

2CH 

Get time 

2DH 

Set time 

2 EH 

Set/reset verify flag 

2FH 

Get Disk Transfer Address 

30H 

Get DOS version number 

31H 

Keep a process 
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Table 6-5. DOS Function Calls, Numeric Order (continued) 


Value 

Function 

33H 

Set/check CONTROL + C state 

35H 

Get interrupt vector 

36H 

Get disk free space 

37H 

Change incompatible 

configuration parameters 

38H 

Return country-dependent 
information 

39H 

Create a subdirectory 

3 AH 

Remove a directory entry 

3BH 

Change the current directory 

3CH 

Create a file 

3DH 

Open a file 

3 EH 

Close a file handle 

3FH 

Read from a file/device 

40H 

Write to a file/device 

41H 

Delete a directory entry 

42H 

Move a file pointer 

43H 

Change attributes 

44H 

I/O control for devices 

45H 

Duplicate a file handle 

46H 

Force a duplicate of a handle 

47H 

Return text of current 
directory 

48H 

Allocate memory 

49H 

Free allocated memory 

4AH 

Modify allocated memory block 

4BH 

Load and execute a program 

4CH 

Terminate a process 

4DH 

Retrieve the return code of 
a child process 

4 EH 

Find first file match 

4FH 

Find next file match 

54H 

Return current setting of 
verify flag 

56H 

Move a directory entry 

57H 

Get/set date/time of file 


Sections 6.3.1 and 6.3.2 give detailed descriptions of the function 
calls, in numeric order. 
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6.3.1 Pre-2.0 Function Calls 


hr 


Value 


00H 


Description 

Call 

Return 

Terminate program 

AH=00H 

CS—segment address of 

None 


Program Segment 
Header 



This function is called by Interrupt 20H. The function performs the 
same processing as Interrupt 20H. All file buffers are flushed to 
disk. The system restores the following exit address from the 
specified offsets in the Program Segment Header: 


• OAH—program terminate 

• OEH—CONTROL + C 

• 12H—Critical error 


Example: xor AH,AH 
int 21H 


WARNING: 

Before calling this function, close all files that have changed in length; 
otherwise, the directory will record the incorrect length. 


Read keyboard and echo AH = 01H AL—character typed 

This function waits for input characters from the keyboard, echoes 
the character to the display, and returns the character in AL. If 
the character is CONTROL + C, Interrupt 23H is executed. 

Example: mov AH,01H 
int 21H 


02H 


Display character AH=02H None 

DL—character 

to be displayed 

This function displays the character in DL. If the character is 
CONTROL + C, Interrupt 23H is issued. 

Example: mov DL,character 
mov AH,02H 
int 21H 
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3H Auxiliary input AH=03H AL—character from 

auxiliary device 

This function waits for a character from an auxiliary input device 
and places it in AL. It does not return a status or error code. It 
the character is CONTROL + C, Interrupt 23H is issued. 

Example: mov AH,03H 
int 21H 


H Auxiliary output AH=04H None 

DL—character for 
auxiliary device 

This function sends the character in DL to an auxiliary output 
device. It does not return a status or error code. If the 
character is CONTROL + C, Interrupt 23H is issued. 

Example: mov AH,04H 
int 21H 


j 5H Print character AH=05H None 

DL—character for 
printer 

This function prints the character in DL on the standard printer. 
If the character is CONTROL + C, Interrupt 23H is issued. 

Example: mov DL,character 
mov AH,05H 
int 21H 


OSH 


Direct console I/O AH=06H 

DL (see below) 


AL (see below) 


This function does not check for CONTROL + C. Depending on the 
value in DL when you call the function, it completes different 
processes as follows: 

• DL=FFH—If a character is typed at the keyboard, the 
function returns it in AL and the zero flag is 0; if a 
character has not been typed, AL=00H and the zero flag is 1. 

• DL (not) =FFH—The function displays DL. 


Example: 


mov 

DL,switch 

mov 

AH,OSH 

int 

21H 
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Direct console input AH=07H AL-character from 

keyboard 

This function waits for input from the console and returns the 
character in AL. It does not echo the character or check for 
CONTROL + C. 

Example: mov AH,Q7H 
int 21H 


08H 


Read keyboard AH=08H 


AL—character from 
keyboard 


This function waits for input from the keyboard and 
character in AL. It does not echo the character, 
is CONTROL + C, Interrupt 23H is issued. 


returns the 
If the character 


09H 


Example: mov AH,08H 
int 21H 


Display string AH=09H 

DS:DX—string to be 
displayed 


None 


DX must contain the offset from the segment address in DS of a 
string that ends with $. This function displays the string. 

Example: mov DX,offset string 
mov AH,09H 
int 21H 


OAH 


Buffered keyboard AH=0AH None 

input DS;DX—input buffer 

DX must contain the offset from the segment address in DS of an 
input buffer of the following form: 

Byte Contents 

1 Maximum number of characters in buffer, including the 
CR, which you set 

2 Actual number of characters typed, not counting the 
CR, which the function sets 

^ n Buffer, which must be at least as long as the number 

in Byte 1 
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This function waits for input characters,, reads them, and then 
places them in the buffer starting at the third byte until a 
RETURN. If the buffer fills to one less than the maximum, the 
function ignores any additional characters and sends ASCII 7 (BEL) 
to the display until a RETURN is entered. If the character is 
CONTROL'+ C, Interrupt 23H is issued. 

Example: mov DX,offset string 
mov string,limit 
mov AH,OAH 
int 21H 


3H 


OCH 


Check keyboard status AH=0BH AL AL contains FFH 

when characters are 
in type-ahead 
buffer; AL contains 
00H when no 
characters are in 
buffer 


If CONTROL + C is in the type-ahead buffer. Interrupt 23H is 
issued. 


Example: mov AH,0BH 
int 21H 


Flush buffer, 
read keyboard 


AH=0CH 

When AL contains 1, 6, 

7, 8, or OAH, the 
corresponding function 
is called; for all other 
values, no other 
processing occurs 


AL-0 when type-ahead 
buffer is flushed; 
no other processing 
occurs 


This function empties the type-ahead buffer. 


Example: mov AL, switch 
mov AH,OCH 
int 21H 
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Disk reset AH=ODH None 

Use this function to ensure that the internal buffer cache matches 
the disks in the drives. This function writes buffers that have 
been modified and marks all buffers in the internal cache as free 
While this function flushes all buffers, it does not update 
directory entries. You must close files that have changed to update 
tnejr directory entries. You do not have to call this function 
before a disk change if you have closed all files that have 
changed. Use CONTROL + C interrupt handlers to call this function. 

Example: mov AH,ODH 
int 21H 


Select disk 

This function specifies 
of 1 for the A drive, 2 


AH=0EH 

DL—drive number 

the default disk drive 
for the B drive, etc. 


AL—number of 
logical drives 

in DL, with the value 


Example: mov 
mov 
int 


DL,disk[-64] 
AH,OEH 
21H 


Open file 


AH=0FH 

DS:DX—unopened FCB 


AL—contains OOH 
when directory entry 
found; contains FFH 
when no directory 
entry found 


Refer to Function 3DH, Open a file, for the Version 2.0 function 
call. 


X must contain the offset from the segment address in DS of an 
unopened FCB and then the disk directory is searched for that file. 
If the flie is found, AL returns OOH and the FCB contains the 
following values: 

• If the drive code was 0 (default disk), it now contains the 
actual disk used, which allows you to change the default 
disk without interfering with subsequent operations on the 
file. 

• The Current Block field (Offset OCH) now contains OOH. 

• The Record Size field (Offset OEH) now contains the system 
default of 128. 

• The File Size field (Offset 10H), Date of Last Write field 
(Offset 14H), and Time of Last Write field (Offset 16H) 
contain new values from the directory entry. 
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10H 


11H 


Before performing a sequential disk operation of the file, set the 
Current Record file (Offset 20H). Before completing a random disk 
operation of the file, set the Relative Record field (Offset 21H). 

If the default record size (128 bytes) is not correct, set it to the 
correct length. 

Example: mov DX,offset fcb 
mov AH,OFH 
int 21H 


Close file AH=10H AL—contains 00H 

DS:DX—opened FCB when directory 

entry found; 
contains FFH when 
directory entry not 
found 

Refer to Function 3EH, Close a file handle, for the Version 2.0 
function call. 

Use this function after a file is changed to update the directory 
entry. DX must contain the offset to the segment address in DS of 
an opened FCB. This function searches for the file named in the 
FCB. If the file is found, this function compares the location of 
the file to the corresponding entries in the FCB, and updates the 
directory entry, when necessary. 

Example: mov DX,offset fcb 
mov AH,10H 
int 21H 


Search for first entry AH=11H AL—contains 00H 

DS:DX—unopened FCB if directory entry 

found; contains FFH 
if no directory 
entry found 

DX must contain the offset from the segment address in DS of an 
unopened FCB. This function searches the disk directory for the 
first matching name, which can include the special file character 

To search for hidden files, DX must point to the first byte of 
the extended FCB prefix. If no match is found, an unopened FCB of 
the same type (normal or extended) is created at the Disk Transfer 
Address and AL contains 00H. 

If you use an extended FCB, the following search pattern is used: 

• If the FCB attribute is 0, the function locates only normal 
files and does not return entries for volume label, 
subdirectories, hidden and system files. 
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If you set the Attribute field for hidden or system files, 
or for directories, this function locates all entries 
matching the specified attributes. To look at all 
directory entries except the volume label, set the 
attribute byte to hidden+system+directory (all three bits 
on). - 


-8 If you set the Attribute field for volume label, thi~ 
function returns only the volume label. 

Example: mov DX,offset,fcb 
mov AH,11H 
int 21H 


12H 


Search for next entry 


AH=12H 

DS:DX—unopened FCB 


AL—contains OOH 
if directory entry 
found; contains FFH 
if no directory 
entry found 

Use this function only after an 11H function call to continue the 
search for files that match the special file character DX must 

contain the offset from the segment address in DS of an FCB, which 
you previously specified in a call to Function 11H. To search for 
hidden or system files, DX must point to the first byte of the 
extended FCB prefix. If a file is found, the system creates an 
unopened FCB of the same type at the Disk Transfer Address. 


Example: mov 
mov 
int 


DX,offset fcb 

AH,12H 

21H 


13H 


Delete file 


AH=13H 

DS:DX—unopened FCB 


AL—contains OOH 
if directory entry 
found; contains FFH 
if no directory 
entry found 

DX must contain the offset from the segment address in DS of an 
unopened FCB. This function searches the directory for a match, 
including matches for the special file character "?". If a match is 
found, this function deletes it from the directory. 


Example: mov 
mov 
int 


DX,offset fcb 

AH,13H 

21H 
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Sequential read 


4H 


AH=14H AL—contains 00H if 

DS:DX—opened FCB read successful, 1 

if EOF, 2 if DTA 
too small, or 3 if 
EOF partial record 


Refer to Function 3FH, Read from file/device, for the Version 2.0 
function call. 


DX must contain the offset from the segment address in DS of an 
opened FCB. This function loads at the Disk Transfer Address the 
record that the Current Block field (Offset OCH) and Current Record 
field (Offset 20H) point to; then this function increments the 
Current Block and Current Record fields. This function sets the 
record size to the value at Offset OEH in the FCB. 


Example: mov 
mov 
int 


DX,offset fcb 

AH,14H 

21H 


i:;H 


Sequential write AH=15H AL—contains 00H if 

DS:DX—opened FCB write successful, 1 

if disk full, 2 if 
DTA too small 

Refer to Function 40H, Write to file/device, for the Version 2.0 
function call. 


DX must contain the offset from the segment address in DS of an 
opened FCB. This function writes from the Disk Transfer Address the 
record that the Current Block field (Offset OCH) and Current Record 
field (Offset 20H) point to; then this function increments the 
Current Block and Current Record fields. This function sets the 
record size to the value at Offset OEH in the FCB. If the Record 
Size is less than a sector, this function writes the data at the 
Disk Transfer Address to a buffer. Then the system writes the 
buffer to disk when it contains a full sector, when you close the 
file, or when you issue a Reset Disk call. 

Example: mov DX,offset fcb 
mov AH,15H 
int 21H 
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AL—contains 00H 
if empty directory 
found; contains FFH 
when no empty 
directory found 

Refer to Function 3CH, Create a file, for the Version 2.0 function 
call. 

DX must contain the offset from the segment address in DS of an 
unopened FCB. This function searches the directory for an empcy 
entry or an existing entry for the specified filename. If this 
function finds an empty directory, it initializes it to a 
zero-length file, calls the Open File call (OFH), and returns 00H in 
AL. You can create a hidden file by using an extended FCB with the 
attribute byte (Offset FCB-1) set to two. " ' 

If this function finds a match for the specified filename, it 
releases all data in the file, creating a zero-length file, and 
calls the Open File call, i.e., it erases the existing file and 
creates a new one. 

Example: mov DX,offset fcb 
mov AH,16H 
int 21H 


AL—contains 00H 
if directory entry 
found; contains FFH 
when directory 
entry not found or 
destination already 
exists 

DX must contain the offset from the segment address in DS of an FCB 
with the drive number and filename filled in, followed by a second 
filename at Offset 11H. This function searches the disk directory 
or an entry that matches the first filename, which can contain the 
special file character If this function finds a match, it 

changes the filename in the directory entry to match the second 
filename in the modified FCB. If the special file characters 
are in the second filename, it does not change the corresponding 
characters in the filename of the directory entry. 

Example: mov DX,offset fcb 
mov AH,17H 
int 21H 


Rename file AH=17H 

DS:DX—modified FCB 
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Current disk 


AH=19H 


- 9H 


.AH 


21H 


AL—currently 
selected drive 


This function returns the currently selected drive in AL, where 0 
specifies the A drive, 1 specifies the B drive, etc. 

Example: mov AH,19H 
int 21H 


Set Disk Transfer AH=1AH None 

Address DS:DX—Disk Transfer 

Address 

This function sets the Disk Transfer Address to the offset in DX 
from the segment address in DS. Disk transfers cannot wrap around 
from the end of the segment to the beginning, nor can they overflow 
into another segment. If you do not set the Disk Transfer Address, 
DOS defaults to Offset 80H in the Program Segment Header. 


Example: mov DX,offset buffer 
mov AH,1AH 
int 2IH 


Random read AH=21H AL—contains 00H 

DS:DX—opened FCB when read 

successful, 01H 
when EOF and no 
data in record, 02H 
when DTA too small 
and read cancelled, 
03H when EOF and 
partial record read 
and padded with 
zeros 

DX must contain the offset from the segment address in DS of an 
opened FCB. This function sets the Current Block field (Offset OCH) 
and Current Record field (Offset 20H) to agree with the Relative 
Record field (Offset 21H), and then it loads the record addressed by 
these fields at the Disk Transfer Address. 


Example: mov DX,offset fcb 
mov AH,21H 
int 21H 
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22H 


Random write 


AH=22H 

DS:DX—opened FCB 


AL—contains 00H 
when write 
successful, 1 when 
disk is full, 2 
when DTA too small 
and write cancelled 

DX must contain the offset from the segment address in DS of an 
opened FCB. This function sets the Current Block field (Offset OCH) 
and Current Record field (Offset 20H) to agree with the Relative 
Record field (Offset 21H), and then i v t writes the record addressed 
by these fields from the Disk Transfer Address. If the record size 
is smaller than a sector (512 bytes), the records go to a buffer 
until a sector is ready to write. 


Example: mov 


'mo\T“ 

int 


DX,offset fcb 

AIt,22 K 

21H 


23H 


File size 


AH=23H 

DS:DX—unopened FCB 


AL—contains 00H 
when directory 
entry found, FFH 
when no directory 
entry found 

DX must contain the offset from the segment address in DS of a 
unopened FCB. Set the Records Size field (Offset OEH) to the proper 
value before calling this function. This function searches the disk 
directory for the first matching entry. If it finds a match, it 
sets the Relative Record field (Offset 21H) to the number of records 
the file, calculated from the total file size in the directory 
entry (Offset 1CH) and the Record Size field (Offset OEH). If the 
value of the Record Size field does not match the actual number of 
characters in a record, this function returns an incorrect file 
size. If the file uses a record length different than the default 
size (128 bytes), you must set the Record Size field to the correct 
value before calling this function. 


Example: mov 
mov 
int 


DX,offset fcb 

AH,23H 

21H 
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Set relative record AH=24H None 

DS:DX—opened FCB 

DX must contain the offset from the segment address in DS of an 
opened FCB. This function sets the Relative Record field (Offset 
21H) to the same file address as the Current Block field (Offset 
OCH) and Current Record field (Offset 20H). 

Example: mov DX,offset fcb 
mov AH,24H 
int 21H 


5H Set vector AH=25H None 

AL—contains interrupt 
number 

DS:DX—interrupt- — 

handling routine 

Use function 25H to set a particular interrupt vector. The 
operating system then can manage the interrupt on a per-process 
basis. Never set interrupt vectors by writing them directly in the 
low-memory vector table. DX must contain the offset to the segment 
address in DS of an interrupt-handling routine. AL must contain the 
number of the interrupt handled by the routine. Then, this function 
sets the address in the vector table for the specified interrupt to 
DS:DX. 

Example: mov AL,interrupt 
push DS 

mov AX,seg_addr 
mov DS,AX 
mov DX,off_addr 
mov AH,25H 
int 21H 
pop DS 


27H Random block read AH=27H AL—contains 00H 

DS:DX—opened FCB when read succeeds, 

CX—number of blocks 1 when EOF (no 

to read data), 2 when end 

of segment, 3 when 
EOF partial record 
and padded with 
zeros 

CX—contains number 
of blocks read 
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DX must contain the offset to the segment address in DS of an opener. 
FCB. CX must contain the number of records to read; if it contains 
zero, this function returns without reading any records. This 
function reads the specified number of records, calculated from the 
Record Size field (Offset OEH), at the record specified by the 
Relative Record field (Offset 21H). It then places the records at 
the Disk Transfer Address. At return, the system sets the Current 
Block field (Offset OCH), Current Record field (Offset 20H), and 
Relative Record field (Offset 21K3 to address the next record. 


Example: mov 
mov 
mov 
mov 
int 


DX,offset fcb 
CX,count 

word prt fcb[14],rec_size 

AH,27H 

21H 


Random block write 


AH=28H 

DS:DX—opened FCB 
CX—number of blocks 
to write or zero 
to set File Size 
field 


AL—contains OOH 
when write 
successful, 1 when 
disk full, 2 when 
end of segment 
CX—contains number 
of blocks written 


DX must contain the offset to the segment address in DS of an opened 
FCB. CX must contain either the number of records to write or 
zero. This function writes the specified number of records, 
calculated from the Record Size field (Offset OEH) from the Disk 
Transfer Address. It writes the records to the file starting at the 
record specified in the Relative Record field (Offset 21H) of the 
FCB. If CX is zero, this function does not write any records, but 
it does set the File Size field of the directory entry (Offset 1CH) 
to the number of records specified by the Relative Record field 
(Offset 21H), and it allocates or releases (as required) the 
allocation units. On return, CX contains the number of records 
written and the system sets the Current Block field (Offset OCH)„ 
Current Record field (Offset 20H), and Relative Record field (Offset 
21H) to address the next record. 


Example: mov 
mov 
mov 
mov 
int 


DX,offset fcb 
CX,count 

word prt fcb[14],rec_size 

AH,28H 

21H 
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H 


Parse file name 


AH=29H 

AL—controls parsing 
(see below) . 

DS:SI—string to parse 
ES:DI—unopened FCB 


AL—contains 00H 
when no special file 
character present, 

1 when special 
file character 
present; FFH when 
drive letter invalid 
DS:SI—first byte 
past string that 
was parsed 
ES:SI—unopened FCB 


SI must contain the offset to the segment address in DS of a string 
(command line) to parse; DI must contain the offset to the segment 
address in ES of an unopened FCB. This function parses the string 
for a filename of the form 


drive:filename.extension 


If it finds a valid filename, it creates a corresponding unopened 
FCB at ES:DI. 


Bits 0 through 3 of AL control the parsing and processing (see 
below). Bits four through seven are ignored. 


Bit 

0 


1 


2 


3 


Value Description 

0 All parsing stops if a file separator is 

encountered. 

1 Leading separators are ignored. 

0 The drive number in the FCB is set to 0 

(default drive) if the string does not 
contain a drive number. 

1 The drive number in the FCB is not changed 

if the string does not contain a drive 
number. 

0 The filename in the FCB is set to eight 

blanks if the string does not contain a 
filename. 

1 The filename in the FCB is not changed if 

the string does not contain a filename. 

0 The extension in the FCB is set to three 

blanks if the string does not contain an 
extension. 

1 The extension in the FCB is not changed if 

the string does not contain an extension. 


( 


K. 
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2AH 


Other actions within this function about which you should be aware 
include the following: 

• If the filename or extension includes an asterisk (*), this 
function sets all remaining characters in the name or 
extension to question marks (?). 

• Filename separators- include the characters:. , 

/ " []\<>| space tab. 

• Filename terminators include all the filename separators 
plus any control character; a filename cannot contain a 
terminator and if it does, parsing stops. 

• If the string does not contain a valid filename, ES:DI+1 
points to a space (ASCII Code 32). 


Example: mov SI,offset string 
mov DI,offset fcb 
push ES 
push DS 
ES 

AL,0FH ;bits 0,1,2,3 on 
AH,29H 
21H 
ES 

AH=2AH CX—year (1980 

through 2099) 

DH—month (1 
through 12) 

DL—day (1 
through 31) 

AL—day of week 
(0=Sunday, 
6=Saturday) 

This function returns the current date set in the operating system 
as binary numbers in CX and DX. 

Example: mov AH,2AH 
int 21H 


pop 

mov 

mov 

int 

pop 

Get date 
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2 EH 


2CH 


Set date AH=2BH AL—contains 00H 

CX—year (1980 through when date is valid 
2099) FFH when date is 

DH—month (1 through invalid 
12 ) 

DL—day (1 through 31) 

Registers CX and DX must contain a valid date in binary. 

CX,year 
DH,month 
DL,day 
AH,2BH 
21H 


AH=2CH CH—hour (0 

through 23) 

CL—minutes (0 
through 59) 

DH—seconds (0 
through 59) 

DL—hundredths (0 
through 99) 

This function returns the current time set in the operating system 
as binary numbers in CX and DX. 

Example: mov AH,2CH 
int 21H 


Example: mov 
mov 
mov 
mov 
int 

Get time 


2DH 


Set time 


AH=2DH 

CH—hour (0 through 
23) 

CL—minutes (0 through 
59) 

DH—seconds (0 through 
59) 

DL—hundredths (0 
through 99) 


AL—contains 00H 
when time is valid 
FFH when time is 
invalid 


Registers CX and DX must contain a valid time in binary. 


Example: mov 
mov 
mov 
mov 
mov 
int 


CH,hour 
CL,minutes 
DH,seconds 
DL,hundredths 
AH,2DH 
21H 
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6.3. 
) 2 EH 


2FH 


) 

3 OH 


DOS 2.0 Function Calls 


Set/reset verify flag AH=2EH None 

AL—contains 00H to 
not verify, 
contains 01H to 
verify 

DOS checks this flag each time it writes to a disk. This flag is 
normally off, but you may wish to set it when writing critical data 
to disk. However, because disk, writes with verification are slow 
you would usually leave the flag off. 

Example: mov AL,switch 
mov AH,2EH 
int 21H 


ES:BX—points to 
Disk Transfer 
Address 

This function returns the DMA transfer address. There are no error 
returns. 

Example: mov AH,2FH 
int 21H 


Get Disk Transfer AH=2FH 

Address 


Get DOS version number AH=30H 


AL—major version 
number 

AH—minor version 
number 


? n ,r it i irn ' 1S the two-part version designation; e.g., for DOS 

1.28, AL contains 1 and AH contains 28. For pre-1.28 versions, AL 
contains 00H. DOS Version 1.1 is the same as 1.10, not 1.01. There 
are no error returns. 


Example: mov AH,3OH 
int 21H 
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• 1H 


3 3H 


Keep process AH-31H None 

AL—exit code 
DX—memory size, in 
paragraphs 


This function terminates the current process and attempts to set the 
initial allocation block to a specific size in paragraphs. It does 
not free up any other allocation blocks belonging to that process. 
You can retrieve the exit code passed in AX by the parent via 
Function 4DH. Use this method to complete this function rather than 
using Interrupt 27H because it allows more than 64KB to be kept. 


Example: mov 
mov 
mov 
int 


AL,exitcode 
DX,parasize 
AH,31H 
21H 


Set/Check AH=33H DL—contains 00H 

CONTROL+C state AL—set to 00H to when off, 1 when 

request current on 

status 1 to set 
state 

DL—if AL=1, contains 
0 to turn off 
or 1 to turn on 

DOS usually checks for a CONTROL + C on the controlling device only 
when completing Function Calls 01H through OCH to that device. Thi 
function allows you to expand this checking to include any system 
call. For example, with the CONTROL + C trapping off, all disk I/O 
proceeds without interruption; with CONTROL + C trapping on, the 
CONTROL + C interrupt is given at the system call that initiates the 
disk operation. If your program uses Calls 06H or 07H to read 
CONTROL + C as data, then the CONTROL + C check must be off. If AL 
does not contain 00H or one, it will contain FFH on return. 


Example: 


mov DL,val 
mov AH,33H 
mov AL,func 
int 21H 
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Get interrupt vector AH=35H ES:BX—pointer to 

AL interrupt number interrupt routine 

this function returns the interrupt vector associated with an 
interrupt. Never get an interrupt vector by reading the low-memory 
vector table directly. There are no error returns. 

Example: mov AH,35H : : 

mov AL,interrupt 
int 21H 


BX—available 
clusters 

DX—clusters per 
drive 

CX—bytes per sector 
AX—contains FFFFH 
if drive number is 
invalid; otherwise 
sectors per cluster 

This function returns free space on disk along with the additional 
information listed above about the disk. 

Example: mov AH,36H 
mov DL,drive 
int 21H 


36H Get disk free space AH=36H 

DL—drive (0=default, 
1=A, etc.) 
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37H Change incompatible AH=37H AL—contains 

configuration parameters AL -subfunction FF if the 

code (see below) subfunction code 
is invalid; if 
AL=0, DL contains 
the DOS switch; if 
AL=2, DL contains 
the device 
availability byte 

This function performs one of the following subfunctions according 
to the code in AL: 

Code Subfunction 

0 DL returns the DOS switch character. The default 

is . 

1 The switch character is set to the character passed 
in DL. 

2 DL is set to the device availability byte. If DL is 
00H, devices must be accessed by coding /dev/<device> 
in file I/O calls. If this byte is non-zero, the 
devices are available at every level of the directory 
tree (e.g., CON is the console device, not the file 
CON). 

3 The device availability byte is set to the value 
passed in DL. 


38H 


Return country- AH=38H 

dependent information DS:DX—pointer to 32- 

byte memory 
area 

AL—country code, zero 
for current 
country 


AX—contains 2 
when country code 
not found 

DX:DS—contains 
country data 


You can use this call only with DOS Version 2.01 and higher. AL 
contains the country code, which is usually the international 
telephone prefix code, or zero for the current country. When DX 
contains -1, the call sets the current country to the current code 
contained in AL. If this function does not find the specified 
country code, it does not change the current country. 


If the country code is valid, DX:DS points to a 32-byte memory area 
that contains the country-specific information. This memory area 
must be able to accommodate 32 bytes. Most of the entries in this 
table are ASCIZ strings, but each field is a fixed size to allow for 
easy indexing to the table. The information provided includes, in 
the order presented below, the following: 
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Size 


Description 


Word 
5 bytes 
2 bytes 
2 bytes 
2 bytes 
1 byte 
1 byte 

1 byte 
Dword 

2 bytes 


Date/time format 

ASCI2 string for currency symbol 
ASCIZ string for decimal separator 
ASCIZ string for date separator 
ASCIZ string for time separator 
Bit field 
Currency places 
Time format 
Case mapping call 

ASCIZ string for data list separator 


■The- specific fields contain the following information: 


• The date/time format, which has the following values: 

0 for USA standard (date is month/day/year, time 
is hours:minutes:seconds) 




1 for Europe standard (date is day/month/year 
time is hour:minutes:seconds) 


2 for Japan standard (date is year/month/day 
time is hour:minutes:seconds) 


The Bit field contains eight bit values and you should 


Bit 0 contains 0 
currency amount, 
follows amount. 


if currency symbol precedes the 
contains 1 if currency symbol 


Bit 1 contains 0 if currency symbol immediately 
precedes currency amount, contains 1 if there is 
a space between the currency symbol and the 
amount. 


• The time format has the following values: 

“ 0 for 12 -hour time 

1 for 24-hour time 

• The Currency Places field specifies the number of places 

appear a ter the decimal point on currency amounts. 

• ™^ Se MaPP ^ r>9 Cal1 is 3 FAR Procedure that performs 
vaino r 5 , * SPeC oni C lower-to-u PPercase mapping on character 
Zoned fro ™ 80 » to FFH - Call it With the character to be 
th P ? -v/" 4 . and .^ t returns the correct uppercase code for 
that character, if any, in AL. AL and FLAGS are the only 
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registers altered. You can pass this routine code below 80H; 
however, no change would occur to these characters. If you do not 
use this call, no changes to AL occur. 

Example: mov AH,38H 

mov AL,country_code 
int 21H 


iriix Compatible Function Calls 


9H Create subdirectory AH=39H 

DX:DS—pointer to 
pathname 


AX—contains 3 if 
path not found or 
invalid; 5 if 
directory could not 
be created (no room 
in parent), 
directory already 
exists, or a device 
name was specified 


3AH 


This function creates a new directory entry with the name specified 
by the pointer to an ASCIZ name. 


Example: Ids DX,name 
mov AH,39H 
int 21H 


Remove a directory 
entry 


AH=3AH 

DS:DX—pointer to 
pathname 


AX—contains 3 if 
path not found or 
invalid; 5 if path 
not empty, not a 
directory, the root 
directory, or 
contains invalid 
information; 16 if 
path specified is 
the current 
directory on the 
drive 


This function removes the path from the directory specified by the 
ASCIZ string. 


Example: Ids 
mov 
int 


DX,name 
AH,3AH 
21H 
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Change the current 
directory 


AH=3BH 

DS:DX—pointer to 
pathname 


AX—contains 3 
if path indicated 
a file or was 
invalid 


This function changes the current directory to that specified by the 
ASCI2 string. If any member of the specified pathname does not 
exist, this function does not change the current directory. 


Example: Ids DX,name 
mov AH,3BH 
int 21H 


Create a file 


AH=3CH 

DS:DX—pointer to 
filespec 

CX—file attribute 


AX—contains 3 
when path not found 
or invalid; 4 when 
too many open files 
(no free handles 
available for the 
process or the 
internal system 
tables were full); 

5 when access 
denied 

AX—when carry flag 
not set for error, 
contains handle 
number 


This function either creates a new file in the appropriate directorv 
or truncates an old file to zero length in preparation for writing." 
It gives a new file the attribute specified in CX (for list of 
attributes, refer to Function 43H). On return, the file handle is 
open for read/write access. An error code of 5 in AX indicates that 
access has been denied for one of the following reasons: 

• Attributes specified in CX contain an attribute that could 
not be created. 


The file specified already exists with a more inclusive set 
of attributes. 


A directory with the same name exists. 


Example: Ids 

DX,name 

mov 

AH,3CH 

mov 

CX,attribute 

int 

21H 
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H Open a file AH=3DH AX—contains 2 when 

AL—contains 0 for file not found, 4 

file open for read, when too many open 
1 for open for files, 5 when access ^ 

write, 2 for open denied, 12 when 

for read and write invalid access 

DS:DX—points to file AX—when carry 

name (ASCIZ string) flag not set, is 
handle number 

This function associates a file with a 16-bit file handle. This 
function sets the read/write pointer at the first byte of the file 
and sets the record size of the file to one byte. You must use the 
returned file handle for subsequent I/O to the file. 

Example: Ids DX,name 
mov AH,3DH 
mov AL,access 
int 21H 


3EH Close a file handle AH=3EH AX—contains 

BX—file handle 6 for invalid handle 

This function closes the file associated with the file handle 
specified in BX and flushes internal buffers. 

Example: mov BX,handle 
mov AH,3EH 
int 21H 


3FH Read from file/device AH-3FH 

DS:DX—pointer to 
buffer 

CX—bytes to read 
BX—file handle 


t 


AX—5, when access 
denied (handle not 
in mode for read), 

6 when invalid 
handle (not open); 
when carry not set, 
contains number of 
bytes written 
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40H 


this function transfers the specified number of bytes from a file 
into a buffer location. It does not necessarily read all the bytes 
(e.g., it reads only one line of text from the keyboard) and a 
return value of zero indicates that it has tried to read from the 
end of file. It uses normalized pointers to complete all I/O and no 
segment wraparound occurs. 


Example: 


Ids 

DX,buf 

mov 

CX,count 

mov 

BX,handle 

mov 

AH,3FH 

int 

21H 


Write to file/device 


AH=40H 

DS:DX—pointer to 
buffer 

CX—bytes to write 
BX—file handle 


AX—contains 5 when 
access denied 
(handle not in 
mode for write), 6 
for invalid handle, 
(not open); when 
carry flag not set, 
contains number of 
bytes written 


This function transfers the specified number of bytes from a buffer 
into a file. If the number of bytes written is not the same as 
requested, it may not necessarily be an error. If you specify the 
count in CX as zero, this function sets the file size to the current 
position and allocates or releases allocation units, as required. 
This function uses normalized pointers for I/O and no segment 
wraparound occurs. 


Example: ]ds 
mov 
mov 
mov 
int 


DX,buf 
CX,count 
BX,handle 
AH,40H 
21H 


41H 


Delete a directory 
ent ry 


AH=41H 

DS:DX—points to 
path name 


AX—contains 2 when 
file not found or 
invalid, 5 when 
access denied 
because path 
specified was a 
directory or 
read-only 


This function removes the directory entry associated with the 
specified filename. 
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42H 


43H 


Example: Ids DX,name 
mov AH,41H 
int 21H 


Move file pointer 


AH=42H 

CX:DX—distance to 

move, in bytes 
AL—method of move 
(see below) 

BX—file handle 


AX—contains 1 for 
invalid function 
number, 6 for 
invalid handle (not 
open); if carry 
flag not set, DX:AX 
contains new 
pointer location 


This function moves the read/write pointer according to one of the 
methods you specify in AL. 


Value Method 

0 The pointer is moved to offset bytes from the 

beginning of the file. 

1 The pointer is moved to the current location plus 
offset. 

2 The pointer is moved to the end of file plus offset. C 


The offset is a 32-bit signed integer with CX occupying the most 
significant 16 bits, which means that you can move forward and 
backward in the file. 


Example: mov 
mov 
mov 
mov 
mov 
int 


DX,offsetlow 
CX,offsethigh 
AL,method 
BX,handle 
AH,42H 
21H 


Change attributes 


AH=43H 

DS:DX—points to 
filespec 

CX—contains attribute 
to set if AL=01H 
AL—contains function 
code (see below) 


AX—contains 1 for 
invalid function 
number, 3 when path 
not found or 
invalid, 5 when 
access denied 
(attribute(s) 
specified in CX 
cannot be changed) 
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This function sets (or gets) the file to which DS:DX points to the 
attributes specified in CX. This function code in AL specifies the 
following actions: 


Value . Action 

0 Return the attributes #f the file in CX. 

1 Set the attributes of the file to those in CX. 


The attributes include the following: 
Bit Attribute 


0 0=read and write 

l=read only 

1 l=hidden file 

2 l=system file 

3 1=volume ID 

4 l=directory 

5 l=file created or written to. (This bit is set when 
the file is created or written to and is typically 
turned off by an archive or backup routine.) 


Example: Ids 
mov 
mov 
mov 
int 


DX,name 

CX,attribute 

AL,func 

AH,43H 

21H 


44H 


I/O control for AH=44H 

BX—handle 

BL—drive <0=default, 

1=A, etc.) 

DS:DX—data or buffer 
CX—bytes to read or write 
AL—function code (see 
below) 


AX—contains 1 for 
invalid function 
number, 5 for 
access denied, 6 for 
invalid handle (not 
open), 13 for 
invalid data; 
for carry flag not 
set, AL equals 2, 

3, 4, 5; AX 
contains count 
transferred; AL 
equals 6,7 (00H 
when not ready, FFH 
when ready) 


This function sets (or gets) device information associated with the 
specified open handle. It also sends or receives a control string to 
a device handle or device. Set AL to one of the values listed below 
to complete the specified function. 
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Value Function 

0 Get device information returned in DX. 

1 Set device information as determined by DX. 

2 Read the number of bytes specified in CX into DS:DX 

from device control channel. 

3 Write the number of bytes specified in CX from DS:DX 
to device control channel. 

4 Read the number of bytes specified in CX into DS:DX 
from the drive specified in BL. 

5 Write the number of bytes specified in CX from DS:DX 
to the drive specified in BL. 

6 Get device input status (input from the device to the 
program). 

7 Get device output status (output to the device from 
the program). 

To use this function to get information about device channels, make 
calls on regular files using only the Function Codes 0, 6, or 7 in 
AL. All other codes result in an invalid function error. 

Other information that you need to use this call effectively 
includes the following: 

• For Function Codes AL=0 and AL=1, the upper byte of DX must 
be 0 on a set call, and the format of DX is 


15 14 13 12 11 10 9 
Re C 
se T 

rv R Reserved 
ed L 


876543210 
IERSIIII 
SOAPSSSS 
DFWECNCC 
E C L U 0 I 

V L K L T N 


where ISDEV = 


1 if this channel is a device. 

0 if this channel is a disk file (Bits 8 
through 15 would be 0 in this case). 


) 
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If ISDEV = 1, then 

EOF = 0 if end of file on input. 

RAW = 1 if device does not do any checking of th 
data (this mode gives faster console output). 

RAW =0 if device checks for tabs, and 

CONTROL + Q, R, or S on console output and 
; echoes until a CR on console input. 

ISCLK - 1 if device is the clock device. 

ISNUL = 1 if device is the null device. 

ISCOT = 1 if device is the console output. 

ISCIN = i if device is the console input. 

SPECL = 1 if device is special. 

CTRL= 0 if device cannot do control strings via 
calls AL=2 and AL=3 (you cannot set this bit). 
CTRL = 1 if device can process control strings 
via calls AL=2 and AL=3 (you cannot set this bit). 

If ISDEV = 0, then 

EOF = 0 if channel has been written. 

Bits 0 through 5 are the block device number for 
the channel (0=A:, 1=B:, etc.). 

— Bits 15, 8 through 13, and 4 are reserved. 

Function Codes AL=2 through AL=5 allow you to send or 
receive from a device arbitrary control strings. The 
syntax is the same as for read and write, except for Codes 
4 and 5, which require a drive number in BL instead of a 
handle in BX. 

- The CNTRL bit contains 0 on return to indicate an 
invalid function number. 

- If the drive number is invalid, an access denied 
error code is returned. 

Function Codes AL=6 and AL=7 allow you to check if a file 
handle is ready for input or output. You can use this 
status information to determine if a handle is open to a 
device or if it is open to a disk file. If you want the 
status of a handle open to a disk file, the following 
values are defined: 

Input—Always ready (AL=FFH) until EOF, then 
always not ready (AL=00H) unless current position 
changed via LSEEK. 

- Output—Always ready (AL=FFH) even if disk full 
or not ready (AL=00H). 

Status is defined at the time the system is 
called. 
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46H 


Example: mov 

BX,handle 


or 





mov 

BL,drive 




for 

AL=4, AL=5 where drive equals 0 




for 

default, equals 1 for A drive, etc. 

mov 

DX,data 


or 





Ids 

DX,buf 




mov 

CX,count 




for 

AL=2, AL=3, AL=4, and AL=5 

mov 

AH,44H 




mov 

AL,function 




int 

21H 




Duplicate a file AH=45H 



AX—contains 4 when 


handle BX—file handle no free handle 

available or 
internal system 
tables full, 6 when 
handle in BX not 
open 

This function takes an already open file handle and returns a new 
handle that refers to the same file at the same position. 

Example: mov BX,handle 
mov AH,45H 
int 21H 


Force a duplicate of 
handle 


AH=46H 

BX—existing file 
handle 

CX—new file handle 


AX—contains 4 when 
no free handle 
available or 
internal system 
tables full, 6 when 
handle in BX not 
open 


This function takes an already open file handle and returns a new 
handle that refers to the same file at the same position. If there 
were a file already open on handle CX, it closes it first. 


Example: mov 
mov 
mov 
int 


BX,handle 
CX,new_handle 
AH,46H 
21H 
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47H Return text of current AH=47H AX—contains 15 

directory DS:SI—points to 64- when invalid drive 

byte memory area specified in DL 
DL—drive number 

This function returns the current directory for a particular drive. 
The directory is root-relative and does not contain the drive 
specifier or leading path separator. The 64^byte area that DS:SI 
points to contains the drive and current directory. 


Example: mov 

AH, 47H 

ltis 

SI,area 

mov 

DL,drive 

int 

21H 


NOTE: 

For Functions 48H through 4BH, DOS Version 2.0 allocates to the 
executing program all available memory from the Program Segment 
Header (PSH) to the end of available memory. To allocate memory to 
a process, first free the memory not needed by issuing Function 
4AH. DS and ES contain the PSH segment when your program initiates 
execution. Use the ES value as the beginning of the allocated 
memory block. Then, allocate a block of memory using Function 48H. 
When you allocate memory, you must free that memory block by using 
Function 49H before terminating your program. Otherwise, the DOS 
assumes that the block is unusable until a reboot. 


48H 


Allocate memory 


AH=48H 

BX—size of memory 
to be allocated 


AX—contains 7 when 
the internal 
consistency of the 
memory area has 
been destroyed due 
to changing memory 
of program to area 
that does not 
belong to it; 
contains 8 when not 
enough memory 
available 


Function 48H returns a pointer to a free block of memory that has 
the required size in paragraphs. 


Example: mov BX,size 
mov AH,48H 
int 21H 
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49H 


4 AH 


Free allocated memory 


AH=49H 

ES—segment address of 
memory to be freed 


AX—contains 7 when 
the internal 
consistency of the 
memory area has 
been destroyed due 
to changing memory 
of program to area 
that does not 
belong to it; 
contains 9 when 
block in ES is not 
allocated via 49H 


This function returns a piece of memory to the system pool that it 
allocates. 

Example: mov ES,block 
mov AH,49H 
int 21H 


Modify allocated 
memory block 


to changing memory 
that does not 
belong to program; 
contains 8 when not 
enough memory to 
fill request; 
contains 9 when 
block in BX has not 
been allocated with 
this function 


AH=4AH 

ES—segment address 
of memory area 
BX—requested memory 
area size 


AX—contains 7 when 
the internal 
consistency of 
memory area has 
been destroyed due 


This function attempts to increase or reduce an allocated block of 
memory. 


Example: mov ES,block 

mov BX,newsize 
mov AH,4AH 
int 21H 
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4BH 


Load and execute a 
program 


AH=4BH 

DS:DX—points to 
filespec 

ES:BX—points to 

parameter block 
AL—see below 


AX—contains 1 when 
AL has invalid 
function; 2 when 
file not found; 8 
when not enough 
memory for process 
to be created; 10 
when environment 
was larger than 
32KB; 11 when DS:DX 
points to file in 
EXE format that 
contains inform¬ 
ation that was 
inconsistent 


This function allows a program to load another program into memory 
and, by default, initiate execution. Use Function 49H (Free 
allocated memory) prior to 48H to ensure enough memory is 
available. DS:DX points to an ASCIZ string of the file to be 
loaded. This function codes for AL are as follows: 


Value Function 

0 Load and execute the program—A program header is 

established for the program and the terminate and 
CONTROL + C addresses are set to the instruction after 
the EXEC system call. 

1 Load (do not create) the program header and do nor 

execute program—Use for program overlays. 

Other information you need to use this function call is as follows: 

» When AL=0, the block has the format: 

WORD—segment address of environment 

DWORD—pointer to command line at 80H 

DWORD—pointer to default FCB to be passed at 5CK 

DWORD—pointer to default FCB to be passed at 6CH 

• When AL=3, the block has the format: 

WORD—segment address where file will be loaded 
WORD—relocation factor to be applied to the image 
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Because all open files of a process are duplicated in the 
child process after execution, the parent process has 
control over the meanings of stdin, stdout, stderr, stdaux, 
and stdprn. The parent process, for example, could write a 
series of records to a file, open the file, and then 
execute a sort program that takes its input from stdin and 
writes to stdout. 

The child process can inherit the environment from the 
parent process, which is a block of text strings (less than 
32KB total) that convey various configuration parameters. 

The format of the environment is as follows: 

(paragraph boundary) 

BYTE ASCIZ string 1 
BYTE ASCIZ string 2 

BYTE ASCIZ string n 
BYTE of 0 

- Typically, the environment strings have the form 
parameter=value. 

For example, COMMAND.COM might pass its execution 
search path as follows: 

PATH=A:\BIN:B:\BASIC\LIB 

A zero value of the environment address causes the 
child process to inherit the parent’s environment 
unchanged. 


4CH 


Example: Ids 

DX,name 

les 

BX,blk 

mov 

AH,4BH 

mov 

AL,func 

int 

21H 

Terminate a process AH: 


AL—return code 


None 


This function terminates the current process and transfers control 
to the invoking process. In addition, it can send a return code. 

It closes all files that were open. Use this method to terminate a 
process before using Interrupt 20H or JMP 0 because it has the 
advantage that CS:0 does not have to point to the Program Segment 
Header. 


c 
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4DH 


4 EH 


Example: mov AL,code 
mov AH,4CH 
int 21H 


Retrieve the return AH=4DH AX—exit code 

code of a child 

This function returns the exit code specified by a child only once. 
The exit routine sends the low byte of this code; the high byte is 
one of the following values: 

Value 


0 

1 

2 

3 

Example: mov 
int 


Description 

Terminate/abort 
CONTROL+C 
Hard error 

Terminate and stay resident 

AH,4DH 
21H 


AX—contains 2 when 
file not found; 18 
when no files found 
that match 
description 

This function can accept a filespec with special file characters and 
a set of attributes. It finds all files that match the filespec and 
have a subset of the required attributes. It writes a datablock at 
the current DMA in the following form: 


find_buf_ re s e rve d 

DB 

21 

DUP (?) 

;Reserved for DOS use on 
subsequent find_nexts 

find_buf_attr 

DB 

7 


;attribute found 

find_buf_time 

DW 

7 


;time 

find_buf_date 

DW 

7 


;date 

find_buf_size 1 

DW 

7 


;low(size) 

find_buf_size_h 

DW 

7 


;high(size) 

find_buf_pname 

DB 

13 

DUP (?) 

;packed name 

find_buf 

ENDS 



To obtain the subsequent matches of the filespec, use Function 4FH. 

Example: mov AH,4EH 

Ids DX,filespec 
mov CX,attr 
int 21H 


rina nrst tile 
match 


AH=4EH 

DS:DX—points to 
filespec 

CX—search attributes 
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4FH 


54H 


56H 


Find next file AH=4FH AX—contains 18 

jnatch when no more matches 

to file description 

This function finds the next matching entry in a directory. The 
current DMA address must point at a block returned by Function 4EH. 

Example: mov AH,4FH 
int 21H 


Return current setting AH=54H AL current 

of verify after verify flag value 

write flag 

This function returns in AL the current value of the verify flag. 

Example: mov AH,54H 
int 21H 


Move a directory entry 


AH=56H 

DS:DX—points to 

pathname of 
existing file 
ES:DI—points to new 
pathname 


AX—contains 2 when 
file in DS:DX not 
found; 5 when access 
denied because DS:DX 
points to directory 
or file that ES:DI 
points to exists, 
or the destination 
directory entry 
could not be created 


This function attempts to rename a file into another path. The 
paths must be on the same device. 


Example: Ids DX,source 
les DI,dest 
mov AH,56H 
int 21H 
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57H 


Get/set date/time AH=57H AX~contains 1 when 

of flle AL—see below) invalid function in 

file handle AL: 6 when invalid 

CX—if AL=0, time handle in BX 

to be set CS/DX—set if 

DX—if AL— 0 , date function 0 

to be set 

Function 57H returns or sets the last-write time for a handle. 

These times are not recorded until the file is closed. Set AL to 
specify whether the date/time should be set or retrieved, as 
follows: 


Value Description 


Return the time/date of the handle in CX/DX. 
Set the time/date of the handle to CX/DX. 


Example: mov 

AH,57H 

mov 

AL,func 

mov 

BX,handle 

mov 

CX,time 

mov 

DX,date 

int 

21H 


if AL=1, then include next two steps 
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CHAPTER 7 
BIOS INFORMATION 


7.1 INTRODUCTION 


!J e f 0 presents information on the Wang PC BIOS, including function 
calis, trappable events, the system configuration table, the screen 
information block pointer, the disk drive control blocks, shared device 
memory, disk I/O requests, and interrupt vector usage. 

the BI0S 3 int!S~ e V n this ® ection is a detailed description of how to use 
tne bios interface to asynchronous communications. 


7.2 


THE SOFTWARE/BIOS INTERFACE 




> lon llsts the functions available from the BIOS according to their 

function numbers. To call these functions from the BIOS, put the function 
number in the AL register and put the other function parameters, if required 
in other registers. The software/BIOS interface entry point is Interr^t 


AL Value 
000H 

001H 

002H 


003H 


Function 

Set the value of ES:BX to point to the system name, "Wang 
Professional Computer", terminated by a null (0) character. 

Set the value of ES:BX to point to the system configuration 
table. 

Set event trap. BX contains the event index, CX contains 
the count of events to occur before issuing trap, and DS:DX 
contains the address of the routine to call when the trap 
occurs. Upon return from the trap routine, BX contains the 
trap queue identification (QID) number. The system returns 
an error code of OSH if the event queue is full. Refer to 
Section 7.3 for a more complete discussion of this function. 

Clear event trap. BX contains the QID of the event trap to 
clear. 
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AL Value 
004H 
005H 
006H 


007H 


008H 


009H 


OOAH 


OOBH 

OOCH 


Function 

Reserved; not available for programmer's use. 

Reserved; not available for programmer's use. 

Send character to the screen. Set BL to contain the 
character to send to the screen. Set BH to contain an 
index that indicates to which screen to send the character; 
use zero for the default screen. This function sends the 
character to the BIOS screen driver, not to the DOS. 

Send one or more bytes to the keyboard. Set CX to contain 
the number of bytes to be sent to the keyboard. If CX = 1, 
then set BL to contain the byte to be sent to the 
keyboard. Otherwise, DS:DX points to a string of bytes to 
be sent. If there is not enough space in the keyboard's 
output buffer, which is currently 32 bytes in size, the 
system returns an error code of 05H in AL. This function 
is particularly useful if you want to use the keyboard's 
sound generation capabilities which requires sending 
several bytes contiguously. 

Enqueue a disk I/O request. DS:BX points to the caller's 
request control block (RCB). Refer to Section 7.8 for a 
description of the RCB. 

Set up DMA channel. The DMA channel you specify in BL is 
set up for the mode of transfer you specify in BH. (Refer 
to the Intel 8237A chip manual for definition of mode.) If 
BH is OFFH, the channel is disabled; otherwise, CX is the 
count of bytes transferred (when CX = 0, it indicates 
64KB), and DS:DX is the buffer address. If the transfer 
crosses a physical 64KB boundary, 004H is returned. 

Allocate DMA channel. On exit, BL contains the channel 
number of the DMA channel, if one is available. If none is 
available, AL returns with 08H as an error code. Similar 
to the event traps, on entry DS:DX points to the routine to 
be called (via a long call) when the end-of-process is 
signaled for that channel. 

Free DMA channel. On entry, BL contains the DMA channel 
previously allocated. 

Reserved; not available for programmer's use. 
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OOEH 


AL Value Function 

OODH Send a block of characters to the screen. Set BH to contai 

the screen index, where zero indicates the default screen. 
Setting BH to nonzero does not change the default. Set CX 
to contain the number of characters to be sent to the 
screen. DS:DX points to the biock of characters to be 
sent. This function sends characters and escape sequences 
to the BIOS screen driver, not to the DOS. Therefore' this 
function provides programs a faster route to the screen than 
the Version 2.0 operating system provides. 

Keyboard query for the status specified by BL. If you 
specify BL as 0, BX returns the device type. If BL is 1, BX 
returns the keyboard PROM version. If BL is 2, BX returns 
the volume control bytes. If BL is 3, BX returns the status 
of the LEDs. Any other value for BL returns an error of 03H 
in AL. 

Console input buffer handler. Use this function to flush 
and check for characters in the input buffer. Upon entry, 

BL contains the subfunction code of 0 to flush the keyboard 
buffer, 1 to read the next character without taking it out 
of the buffer, and 2 to read the next character and remove 
it from the buffer. For Subfunctions 1 and 2, BX returns 
the character with two-byte codes returned as one 16-bit 
value. If the keystroke is a one-byte code, BH is zero. 

For this function only, AL returns 05H if the the keyboard 
buffer is empty. 

010H Warm boot the system. This routine provides a standard 

method for an application program to reboot the system. 

This call is needed so that CPU boards, which need the boot 
PROM to be mapped in before a jump to the warm boot address, 
can be utilized. 

Upon return from the function calls, the AL register contains the 
completion code for each function. The ten completion code values are defined 
as follows: 


00FH 


Value Description 


000H 
001H 
002H 
003H 
00 4H 
005H 
006H 
007H 
008H 
009H 


Function completed normally 

Function index (AL) is invalid 

Function specified has not been implemented 

Invalid parameter(s) specified 

Operation impossible 

Event queue or keyboard buffer full 

Invalid QID specified 

Invalid screen index specified 

Resource allocation denied 

Internal error of unspecifiable nature 
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7.3 BIOS-TRAPPABLE EVENTS 


For BIOS Function 002H (Set event trap), specify which event to trap by 
the index in BX. After the event occurs the number of times specified by 
the count in CX, the BIOS calls (via a far call) the trap routine. If 
the count in CX is zero, the default BIOS logic for the event is 
bypassed. The BIOS assumes that the trap handler goes to the hardware to 
process the interrupt and expects the user-supplied code to handle the 
hardware. If the count in CX is nonzero, the BIOS handles the interrupt 
as it normally does, and then calls the specified trap routine. 


NOTE: 

Because the trap routine call occurs within an interrupt, the trap 
routine cannot call the DOS to perform any functions. Since interrupts 
are disabled and should not be enabled, the trap routine should only set 
a flag that the main routine can act on and then return to the main 
routine. The trap routine must be very quick. For example, if you are 
running serial communications at 19.2KB baud, you are receiving 
characters at 1 per 500 microseconds. Therefore, you can lose characters 
unless the trap routine is very quick. 


When the trap routine call occurs, AX contains the event index. 
Therefore, you can have a single trap routine for several conditions. 
Also, the routine may assume it has up to 64 bytes of stack space and 
that all registers are preserved. Before the trap routine call occurs, 
the count in CX is reset so that the trap can occur again. Only by using 
the QID in the Clear Trap function (002H), which is returned when setting 
the trap, can you clear the trap. These traps are not one-time traps, 
but repeating traps. 

You can trap the following events: 


Index Event 

0000H 10 ms timer (refer to Note 1) 

0001H Serial port input character ready 

0002H Serial port output character ready 

0003H Serial port data set change state (refer to Note 2) 

0004H Parallel port input character ready 

0005H Parallel port output character ready 

0006H Keyboard input character ready 

0008H 8087 interrupt 

0009H CONTROL + C (or SHIFT + CANCEL) trap (refer to Notes 2 

and 3) 

000AH CANCEL key pressed (refer to Notes 2 and 3) 
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Index Event 


0010H 

0011H 

0012H 

0013H 

0014H 

0015H 

0016H 

0017H 

0018H 

0019H 

001AH 

OOIBH through 
OOFFH 

OlOOH through 
OlFFH 


Channel 
Channel 
Channel 
Channel 
Channel 
Channel 
Channel 
Channel 
DMA EOP 
DMA EOP 
DMA EOP 


0 hardware interrupt ( 

1 hardware interrupt ( 

2 hardware interrupt ( 

3 hardware interrupt ( 

4 hardware interrupt ( 

5 hardware Interrupt ( 

6 hardware interrupt ( 

7 hardware interrupt ( 
on DMA channel 1 (refe 
on DMA channel 2 (refe 
on DMA channel 3 (refe 


refer to Note 
refer to Note 
refer to Note 
refer to Note 
refer to Note 
refer to Note 
refer to Note 
refer to Note 
r to Note 2) 
r to Note 2) 
r to Note 2) 


2 ) 

2 ) 

2 ) 

2 ) 

2 ) 

2 ) 

2 ) 

2 ) 


Undefined 


User-definable events (between processes) 


Notes: 

1) You cannot request the 10 ms timer event trap with a count of zero or a 
bad parameter error is returned. 


2) The traps for these events occur regardless of the count in CX, thereby 
ignoring the count specified in CX. 

3) When the CONTROL + C or CANCEL (SHIFT + CANCEL) are trapped, the 
character trapped does not affect the keyboard buffer. The character is 
not placed in the buffer, and the buffer is not cleared on a CONTROL + C 
or CANCEL (SHIFT + CANCEL). 


For all event traps where the count in CX is ignored, all requesters of 
the event trap are invoked. For the other event traps where the count in CX 

is used and is set to zero, only the most recent requester of the trap is 

invoked because only one software package can properly maintain control of the 
hardware. For special application programs where users review keystrokes as 
they are entered and then decide whether to proceed, keystroke interrupts are 
completed using the Software Interrupt Vector 089H. If you wish to intercept 
these interrupts, place the address of the handler routine in the interrupt 
vector for Interrupt 089H. When the BIOS acknowledges a keyboard interrupt, 

it issues a software H Int 089H'*. If the handler routine returns with the 

carry flag on the stack set, the BIOS ignores the keystroke; otherwise, the 
BIOS processes the keystroke normally. The following example sets the carry 
flag on the stack; 


key proc far 

push BP 

mov BP,SP 


or [BP+6],01 

pop BP 

iret 

key endp 
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7.4 SYSTEM CONFIGURATION TABLE 


The system configuration table is maintained by the BIOS and contains 
information concerning the current system configuration. You may obtain its 
location by using the software BIOS interface (Function 01H). 

The format of the system configuration table is as follows: 


Offset 

Name 

Size 

Description 

OOOOH 

VERSION 

Word 

BIOS version (the high byte defines the 
integer portion; the low byte defines 
the decimal portion — for example, 

BIOS Version 1.21 would be coded as 
0115H) 

0002H 

MEMSIZE 

Word 

Size of memory in paragraphs 

0004H 

Reserved 

Dword 

Reserved for future use 

0008H 

SCRNCNT 

Word 

Count of screens in the system 

000AH 

SCRNPTR 

Word 

Screen information block pointer 
(repeated 0 or more times) 

moxxxnH 

DISKCNT 

Word 

Count of disk drives in the system 
(including the two diskette drives) 

imrannH 

FLOPPYO 

Word 

Diskette Drive 0 control block pointer 

mmrooH 

FL0PPY1 

Word 

Diskette Drive 1 control block pointer 

mn*npH 

WINSTAT 

Word 

Winchester control block pointer 
(repeated 0 or more times) 

nnnqH 

SDMCNT 

Word 

Count of extra devices in the system 

nnnr 

SDMPTR 

Word 

Shared Device Memory pointer (repeated 

0 or more times) 


7.5 SCREEN INFORMATION BLOCK 


For each video board, there is a Screen Information Block pointer, which 
contains the offset into the same segment, ES, as the configuration table of a 
screen information block. Each block has the following format: 
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Offset 

Name 

Size 

Description 

0000H 

STATE 

Byte 

Active/Type/Slot information 

0001H 

SCNOFF 

Byte 

Scan register offset 

0002H 

BUFSEG 

Word 

Segment containing frame buffer image 

0004H 

COLORS 

Byte 

Current foreground and background 
colors -(high,nibble—foreground; low 
nibble—background) 

0005H 

ROW 

Byte 

Current row of cursor 

0006H 

COL 

Byte 

Current column of cursor 

0007H 

ATTR 

Byte 

Current attributes 

0008H 

AUXMOD 

Byte 

Auxiliary mode byte (determines board 
interrupt status) 

0009H 

AUXMD2 

Byte 

Second Auxiliary mode byte 

000AH 

MAXROW 

Byte 

Maximum row number on screen 

000BH 

MAXCOL 

Byte 

Maximum column number on screen 

000CH 

COUNTRY 

Byte 

Independent screen country code 

000DH 

X SIZE 

Word 

Graphics resolution for X-axis 

000FH 

Y SIZE 

Word 

Graphics resolution for Y-axis 

0011H 

CHAR 

Byte 

Character buffer 

0012H 

CURST 

Byte 

Current cursor state 

0013H 

SLOT 

Byte 

Slot containing the screen controller 

0014H 

MODE 

Byte 

Screen mode 


The formats for the STATE, ATTR, AUXMOD, and CURST bytes are listed as 
follows: 


STATE 


Bit(s) 

Name 

Description 

3-0 

SLOTID 

Contains the slot number of the selected 
board. 

cn 

1 

rf* 

TYPE 

Contains the type of video board. 


0 = 320 x 200 resolution, low resoluti 

1 = 640 x 200 resolution, low resoluti 

2 = 800 x 300 resolution, medium 

resolution with graphics 

3 = medium-resolution character board 

only 

4 = 800 x 600 resolution (high 

resolution) 

ACTIVE If set, indicates current or default screen. 
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ATTR 

Description 

Blink attribute 
Reverse video attribute 
Blank attribute 

Bold or high-intensity attribute 
Overscore attribute 
Underscore attribute 
Subscripting attribute 
Superscripting attribute 


Description 
Reserved 

Currently in 40-column mode 
Currently in 80-column mode 
This screen generates interrupts 
Smooth scrolling is in effect for this screen 
Currently in Insert mode 

6 AUTOWRAP Currently in Auto-wrap mode 

7 Reserved 

CURST 


Bit(s) 

Name 

Description 

0 

CURSOR 

Cursor is on 

1 

ATTACH 

Cursor is attached 

2 

BLOCK 

Cursor is in Block mode 

3 

BLINK 

Cursor is blinking 

7-4 


Reserved 


The SCNOFF byte contains the number of scan lines that must be added to 
the computed address to map it to the physical location on the screen. The 
values for each of the MAXROW and MAXCOL bytes are one less than the actual 
screen height or width. The COUNTRY byte is initialized to zero at boot 
time. 


Bit(s) 

Name 

0 

BLINK 

1 

REVER 

2 

BLANK 

3 

BOLD 

4 

OVER 

5 

UNDER 

6 

SUB 

7 

SUPER 

AUXMOD 

Bit(s) 

Name 

0 

1 

40COL 

2 

80 

3 

INT 

4 

SMOOTH 

5 

INSERT 


If your program accesses the hardware directly, it is important to 
incorporate into the program the conventions used by the Wang system for 
multiple screens. Only one screen in the system may have its memory enabled 
at any one time. The BIOS convention for the low-resolution and 
medium-resolution screens is that whenever you need to access a screen, enable 
the board’s memory, perform the operation, and immediately disable the memory 
again. If you wish to access the screen memory directly, you must also use 
the following convention: if the interrupt bit is on in the screen control 
block {in AUXMOD), then enable the board with interrupts. If ES:SI points to 
the Screen Control block, the following examples show how to properly enable 
and disable the board: 
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BOARD ON 

mov 

dh, es:[si].slot 

mov 

dl, 010H 

mov 

al, es:[si].auxmod 

and 

al, OCH 

or 

al, 1 

out 

dx, al 

BOARD OFF 

mov 

dh, es:[si].slot 

mov 

dl, 010H 

mov 

al, es:[si].auxmod 

and 

al, OCH 

out 

dx, al 


; Get the board's slot number 
; Address the Memory option port 
; Get the AUXMOD byte from the SCB 
; Extract the inttupt bit and the 
40/80—Column mode bit 
; Turn on the memory-enable bit 
>* And *. enaol e the boa r.d 

; Get the board’s slot number 
; Address the Memory option port 
; Get the AUXMOD byte from the SCB 
; Extract the interrupt bit and the 
40/80-Column mode bit 
; And disable the board 


This also preserves the 40/80-Column mode for the low-resolution 

hii- d H Th * refore ' £ he P ro 9 ram does not require a separate step to add that 
bit, depending on what mode the board is currently in. You cannot use this 
example for accessing the high-resolution screen. Port 10H on the 
lgh resolution board sets the display attribute control byte for bold 
characters, and a program should not modify it. 


7-6 DISK DRIVE CONTROL BLOCKS 


The Disk Drive Control block has the following format: 


Offset 

0000H 

0001H 

0002H 

0003H 

0004H 

0005H 

0007H 

000BH 


Name 

Size 

TYPE 

Byte 

STATE 

Byte 

BPS 

Byte 

SPT 

Byte 

HPC 

Byte 

CPD 

Word 

SPD 

DWord* 

DOS 

Word 


Description 

Disk type 
Drive state 
Bytes per sector 
Sectors per track 
Heads per cylinder 
Cylinders per disk 
Sectors per disk 
DOS Descriptor 


•For BIOS versions greater than 1.21, the size of Offset 0007H is a 
double word. 


control i TYPE) lndicates the type of disk drive for which th« 

disketLs r i nS * nformatlon - The currently defined types are 00H for 

diskettes, 01H for Winchesters, 02H for RAM disks, 03H for Winchester 

t^es <SUPP ° rted by BI0S ver sions greater than 1.21), and OFFH for other 
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The status byte (STATE) has the following code: 


Bit(s) Name Description 


7 

EXIST 

If 

set 

6 

WP 

If 

set 

5 

ACTIVE 

If 

set 

4 

SELECT 

If 

set 

3 

MEDIA 

If 

set 

2 

DISK 

If 

set 

1 

MOTOR 

If 

set 

0 

INIT 

If 

set 


the drive exists 

the disk is write protected 

the drive is active 

the drive is selected 

the disk may have been changed 

a disk is in the drive 

the motor is on 

the drive has been initialized 


NOTE: 

Although some bits may not pertain to some types of disk, they are usually set 
according to their corresponding meanings. 


The bytes per sector (BPS) byte contains the size of the sectors on the 
disk. The only valid values for this byte are 1 for 256-byte sectors, 2 for 
512-byte sectors, and 3 for 1024-byte sectors. 

The DOS descriptor is used to describe the type of file structure that 
resides on a given partition to protect against accidental use of a partition 
formatted for a different DOS. Only two values are currently defined for this 
field: 0 for a generic partition and 1 for an MSDOS partition. The generic 
partition can be read or written through any operating system. 


7.7 SHARED DEVICE MEMORY 


Snared device memory is memory allocated to each board in the system that the 
BIOS does not support as either a screen or a disk. Shared device memory is 
designed to act as a mediator for software packages that access the hardware. 
Por example, you could use the Shared Device Memory Control block supplied by 
the BIOS to reflect the current state of a board and possibly to provide 
information for restoration of the board after an application is complete. 

The format of a shared device memory control block is as follows: 
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Offset Name 

Size 

0000H 

0001H 

SLOT 

DEVICEID 

Byte 

Byte 

0002H 

STATE 

Byte 

0003H 

0004I-: 

through 

Word 

0008H 

OOOFH 

through 

11 

Bytes 


Description 

Slot number containing board 
Identification of the board (as 
returned from Port OFEH) 

Software state of the board; zero 

indicates inactive 

Segment address currently mapped to 

Device specific information 


You can (ietine the format of the 11-byte device specific information 
area ana the definition of the STATE byte. The only exception is that to 
indicate inactivity, the STATE byte must be zero. When you use these Control 
blocks within a software application, you should adhere to the standards 
defined for this facility for a specific board. Different boards have 
different information in the control blocks, but to maintain compatibility 
among applications for specific boards, you should follow the standards listed 


7*7.1 IEEE-488 (GPIB) Interface Option Board 


) 


The format of the 
follows: 


SDM block allocated to the GPIB option board is defined as 


Offset 


Description 


0 

1 

2 


3-4 

5-6 
7-8 
9-11 
12 - 13 
14 - 15 


Slot number of the board 

Option identification of the board (020H for the GPIB board) 
Software state of the board. The values for this byte are 
as follows: 

0000H = Inactive 
0001H = GPIB access 
0002H = SIO access 
0003H = CP/M access 
3004H = Print function access 
0005H = Background (off-line) access 
0006H = PAXNET access 
0007H = 928 emulator access 
0008H = Optical disk access 
0009H through OOFH are reserved for GPIB 
0010H through OFFH are available for redefinition 
Segment address board currently mapped to (set to OFFFFH 
when not mapped) 

Offset to external register file 
Reserved for GPIB, currently not defined 
Available for redefinition 
Offset to any user-defined data area 
Segment of any user-defined data area 
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7.7.2 Local Communications Card (928) 


The format of the SDM block for the 928 Card set is as follows: 

Offset Description 

0 Slot number of the board 

1 Option identification of the board (038H for the 928 Card 
set) 

2 Software status. The values for this byte are as follows: 

0000H = Inactive 

0001H = In use by 928 emulator 

0002H = In use by PAXNET 

0003H = In use as a VDISK (virtual disk) 

0004H = In use by RTC software 
0005H = In use by general I/O library 
0006H = In use by PCMS 
0007H = In use by RKG 

0008H through OFFH are currently not defined 
3-4 Segment address board currently mapped to 

5 Host system for terminal emulation (928 emulator only) 

001H = OIS 
002H = ALLIANCE 
003H = VS 

6 Emulator status (928 emulator only) 

Bit 0, 0 

Bit 1, 1 for archiving emulation; otherwise, 0 
Bit 2, 1 for combined, 0 for serial (VS only) 

Bit 3, 1 for run time module invoked 

Bit 4, 0 

Bit 5, 1 for 256-character font, 0 for 128-character 
font 

Bit 6, 0 
Bit 7, 1 

7-15 Currently not defined 
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7.7.3 Three-Port MCC Board 


the definition of the SDM block for the 3 


-port MCC board is as follows: 


Value 

Size 


Description 

000 OH 

. Byte 


Slot number of the’ board 

0001H 

Byte 


ID of the board (1FH) 

0002H 

Byte 


Software state of the board; 
inactive 


D7 D6 

D5 

D4 D3 D2 hi DO 


indicates 


Channel 1 

Channel 2 0=Not Active 
Channel 3 l=Active 
Channel 4 

0=8251 (3 channels) 

1=9251 (4 channels) 

Unused 

Unused 

Unused 


0003H Word 
0005H Byte 
0006H Byte 
0007H Byte 
0008H Dword 
000CH Dword 


Segment address into which the board is currently 
mapped (not used) 

Device attached to Port 1 (Channel 1). Refer to 
Note 1. 

Device attached to Port 2 (Channel 2). Refer to 
Note 1. 

Device attached to Port 3 (Channel 3 and/or 4). 
Refer to Note 1. 

Far pointer to the low-level driver's Interrupt 
Vector Block (IVB). Refer to Note 2. 

Reserved for a link pointer to an additional 
memory block if required. It currently contains 
a NULL pointer (00000000H). 


Notes: 


The following list contains device code definitions for attachment to 
ports (channels) 


Value 


Description 


00H 

01H 

02H 

03H 

04H 

05H through FFH 


No device attached 
Printer 

Asynchronous communication 
Bisynchronous communication 
Mouse 

Not defined 
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2. The following list contains definition of the Interrupt Vector Block 
Hardware Interrupt Vectors 


Value 

Size 

Description 

0000H 

Dword 

Channel 2, SIO Channel B—transmit buffer empty 

0004H 

Dword 

Channel 2, SIO Channel B—external/status change 

0008H 

Dword 

Channel 2, SIO Channel B—receive character 
available 

000CH 

Dword 

Channel 2, SIO Channel B—special receive 
condition 

0010H 

Dword 

Channel 1, SIO Channel A—transmit buffer empty 

0014H 

Dword 

Channel 1, SIO Channel A—external/status change 

0018H 

Dword 

Channel 1, SIO Channel A—receive character 
available 

001CH 

Dword 

Channel 1, SIO Channel A—special receive 
condition 

0020H 

Dword 

Channel 4, DART Channel B—transmit buffer empty 

0024H 

Dword 

Channel 4, DART Channel B—external/status change 

0028H 

Dword 

Channel 4, DART Channel B—receive character 
available 

002CH 

Dword 

Channel 4, DART Channel B—special receive 
condition 

0030H 

Dword 

Channel 3, DART Channel A—transmit buffer empty 

0034H 

Dword 

Channel 3, DART Channel A—external/status change 

0038H 

Dword 

Channel 3, DART Channel A—receive character 
available 

003CH 

Dword 

Channel 3, DART Channel A—special receive 
condition 


10 Millisecond Timer Interrupt Vectors 


Value 

Size 

Description 

0040H 

Dword 

Channel 

1 

0044H 

Dword 

Channel 

2 

0048H 

Dword 

Channel 

3 

004CH 

Dword 

Channel 

4 
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7.8 DISK I/O REQUESTS 


both^LTT.? queu ! ^ rou 9 h the BIOS interface for disk I/O requests for 
both the diskettes and the Winchester disk. The operations are started and 

Thii r allow^ PaSS h d ^ ack 4 - t a ““ application before the operation is complet e d 
Ivlrat 1 sophisticated programs to do other processing while the disk 
operation is executing in the background. Currently, only one disk operation 
can be in progress at any one time. To simplify using the BIOS interface the 

identical 63 Although th^h f ° rn ^ tS for the diskettes and the Winchester are 
identical. Although the basic function codes (e.g., for READ WRITFi a™ 

identical, some functions available for the diskettes are^'a^Sle for 
the Winchester, and vice versa. Dle £or 


The format of the Request Control 
structure, is as follows: 


block. 


presented below as an Assembler 


Request Control Block for Disk I/O 


RCB Struc 


REQUEST Db 
STATUS Db 
DRIVE Db 
SECTOR Dw 
SECTCNT Dw 
BUFFPTR Db 
RETRY Db 
SECT0R2 Dw 
FILL Db 


7 

7 

7 

7 

7 

3 Dup (?) 

7 

7 

3 Dup (?) 


RCB Ends 


; Request code 
; Function Status code 
; Drive select 

; Sector number to be read from or written to 
; Number of sectors to transfer 
; Physical buffer address 
; Number of retries to perform 
, High 16 bits of the sector number 
; Fill of 16-byte RCB (for BIOS Versions 
1.21 and greater, this represents second 
word of 32-bit sector) 
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The descriptions of each of the bytes or words in this Assembler 
cructure are as follows: 


Bytes 

REQUEST 

STATUS 

DRIVE 


Description 


This byte contains the Function Request code for the 
operation to be performed. 


This byte is set to zero when the request is queued. When 
the value changes to nonzero, it indicates completion and 
status of the request. 080H indicates normal completion; 
any other value indicates an error. 


This byte contains the drive number of the request. Values 
zero and one always refer to diskettes A and B, 
respectively, regardless of the system configuration. 

Values of two and above refer to the Winchester drive(s), 
ordered sequentially from slot numbers assigned to each 
controller board. 


SECTOR This word indicates the physical sector number on the drive 

where the operation is to be performed. The first sector 
on any disk is Sector zero. For format requests, this 
field contains the number of a sector on the track to be 
formatted. 


SECTCNT This word contains the number of sectors to be transferred 

for a READ, WRITE, or VERIFY command. 

BUFFPTR This field contains the 20-bit physical machine address of 

the buffer for READ or WRITE commands. You can compute it 
by adding the value of the base register, first multiplied 
by 16, to the offset. 

RETRY This byte indicates whether or not retries should be 

attempted on the floppy diskettes before returning an 
error. If the value is zero, no retries are done; if the 
value is nonzero, retries are done if necessary, and on 
return, this byte contains the value of the number of 
retries. 

SECT0R2 This field contains the high 16 bits of the sector number 

for a given operation. It is combined with SECTOR to 
create a 32-bit sector number. 

FILL This field is filler to ensure the length of the RCB is 16 

bytes. It is important that these bytes contain zero at 
all times, unless otherwise specified. 
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7 - 8 - 1 Disk I/O Function Request Codes F 


^ following table lists the disk I/O function request codes. The last 

the miTV Whether the faction is meaningful for the diskettes or 

.the Winchester because some functions are not meaningful for both. A comol-i-e 
description of each of the function codes foLlQws tile table. P 


Disk Function 


Request 

Value 

READ 

OCOH 

WRITE 

0C1H 

CHECK 

0C2H 

FMT 

0C3H 

SEEK 

0C4H 

REST 

0C5H 

STATE 

0C6H 

IDLE 

ODOH 

OPEN 

0D1H 

MODE 

OEOH 

WINIT 

OFOH 

WERS 

0F1H 

WERD 

0F2H 

DFMT 

0F3H 

^RRCYL 

■jRCYL 

0F4H 

0F5H 

H > ED 

^ECC 

0F6H 

0F8H 

CLECC 

0F9H 

UPLD 

OFAH 

DNLD 

OFBH 

SIZE 

OFCH 

SRC 

OFDH 

DECO 

OFEH 

EECC 

OFFH 

VER 

008H 


Description 


^l°PPy Winchester 


Read sectors 
Write sectors 
Check sectors 
Format cylinder 
Seek to cylinder 

Restore (return to Cylinder zero) 

Return drive status 

Turn off the motor 

Open the door 

Set drive mode 

Perform power-up diagnostics 
Reset retry count 
Read retry count 
Format entire disk 
Read reserved cylinder 
Write reserved cylinder 
Write protect/enable disk 
Read ECC count 
Reset ECC count 

Upload code from the controller 
Download code from the controller 
Get the drive size 
Set retry count 

Disable ECC checking and correcting 
Enable ECC checking and correcting 
Verify flag for write 


X 

X 

X 

X 

X 

X 

X 

X 

X 

X 


X 

X 

X 

X 


X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 


The Read Sector (OCOH), Write Sector (0C1H), and Verify Sector (0C2H) 
function reque sts have identical Request Control blocks, with theexceptioi 

s ; "f - .wrt sMisiris. vsgL 

iTt? "S” £i * w 

^returned. ^ data ”*** had be ® n corrected via EXX, a status code of 083H 
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To format a track (0C3H), you must set the REQUEST, DRIVE, SECTOR and 
RETRY fields of the RGB. The sector field of the RCB specifies a sector on 
the track to be formatted, which can be any sector contained on the specified 
track. For floppy diskettes, the track is formatted and ready to use. For 
the Winchester, the track is formatted and a write of the entire track is 
required to generate valid ECO. 

The Seek To Cylinder function request (0C4H) results in the head being 
positioned to the cylinder containing the sector specified in the SECTOR field 
of the RCB. The Restore Head function request (0C5H) results in the head 
being positioned to Cylinder zero of the diskette. 

Use the Return Drive Status function request (0C6H) to obtain 
information about the state of the drive. When this request is successfully 
completed, the byte at RCB+3 contains the drive state byte (STATE, defined 

above) and the byte at RCB+4 contains the sector size of the sectors on the 

disk, as coded in BPS of the disk control block. Use the state byte to 

determine if the disk has changed since the last time the drive status was 
requested. If the "media changed" bit is set, the door has been opened 
recently. 

Use the Turn Off Motor function request (ODOH) to turn off the motor on 
the floppy diskette. To lengthen the life time of the motor and drive heads, 
the motor is turned off automatically 6 seconds after you last accessed the 
drive . 


The Open The Door function request (0D1H) allows a program to logically 
open the drive door. Use this function when you want to indicate to the 
operating system that the media has changed so that it reassesses the state of 
the drive and updates the control blocks. 

The Set Drive Mode function request (OEOH through OEFH) affects the 
parameters that the BIOS uses to read, write, and format the floppy 
diskette(s). The following table shows how the BIOS interprets this request 
code. 
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Request Code 

OEOH 

0E1H 

0E2H 

Sector size 

512 

512 

512 


Sectors/track 

9 

9 

8 

Head/cylinder 

1 

2 

1 . 

Tracks/disk 

40 

80 

40 

Sectors/disk 

360 

720 

320 

Format gap 

050H 

050H 

050H 

R/W gap 

02AH 

02AH 

02 AH 


0E3H 

0E4H 

0E5H 

0E6H 

0E7H 

512 

256 

256 

256 

256 


8 

18 

18 

16 

16 

2 

1 

2 

1 

2 

80 

40 

80 

40 

80 

640 

720 

1440 

640 

1280 

050H 

00CH 

00CH 

032H 

032H 

02 AH 

00AH 

00AH 

020H 

020H 


0E8H - 
OEFH 

RCB+3 

See 

Note 1 

RCB+4 

RCB+5 

RCB+6 

See 

Note 2 

RCB+7 

RCB+8 


Notes: 


1) The sector size for Functions 0E8H through OEFH is coded as 128*2**N, 

where N is taken from the RCB. Only three codes are valid: 1 indicates 
256-byte sectors; 2 indicates 512-byte sectors; and 3 indicates 
1024-byte sectors. 


The number of sectors on the disk is computed by the other parameters 
specified in the RGB. 


The Perform Power-up Diagnostics function request (OFOH) causes the 
Winchester controller to rerun its power-up diagnostics. 


The Reset Retry Count function request (0F1H) resets the retry count in 
the Winchester. Read the current retry count by using the Read Retry Count 
function request (0F2H). This function returns the count in the SECTCNT field 
of the RCB, i.e., at the word at RCB+5. 


The Format Entire Disk function request (0F3H) formats the entire 
Winchester disk. After this function is completed, a write of every sector on 
every track is required to ensure valid ECC on the disk. The disk is left 
unprotected (refer to Write Protect/Enable Disk function request (0F6H) below). 

The Read Reserved Cylinder function request (0F4H) and the Write 
Reserved Cylinder function request (0F5H) are identical to the Read and Write 
function requests except that they apply to the reserved cylinder of the 
Winchester. 


Use the Write Protect/Enable Disk function request (0F6H) to 
format-protect the Winchester drive to avoid accidental formatting or 
writing. When you make this request, the byte at RCB+3 contains the control 
bits for write protect, which automatically format-protects the disk. Bit 0 
of the control byte is set if you want to write protect the disk, and Bit 1 is 
set if you want only to format-protect it. If both bits are clear, the disk 
is write and format enabled. 

The Read ECC Count function request (0F8H) reads the ECC count from the 
Winchester controller in the SECTCNT field (word at RCB+5) and the reset ECC 
count (0F9H) resets the ECC count. 
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The Upload From Controller (OFAH) and Download From Controller (OFBH) 
function requests allow a host computer to download new or special code into 
the Winchester controller for execution. You must set the REQUEST, DRIVE, 
SECTCNT, and BUFFPTR fields of the RCB before making this request. Set the 
SECTCNT field to the number of 512-byte blocks of data, with a maximum being 
four. Upload copies the controller Z80 code memory into the 8086 buffer 
specified. Download copies Z80 code into the controller’s code memory and 
starts executing the code when the transfer is complete. 

The Set Maximum Retry Count function request (OFDH) specifies at the 
RCB+3 byte the number of times the Winchester searches for a sector header 
before aborting the request. 

The Disable ECC (OFEH) and Enable ECC (OFFH) function requests disable 
and enable error checking and correction by the Winchester controller. When 
disabled, the controller does not retry bad data or correct bad data; when 
enabled, it checks for bad data and corrects them when necessary. 


7.8.2 Disk I/O Status Codes 


The following list defines the status codes for disk I/O. 


Error 

Status 

Value 

Description 

CK 

08 OH 

Function completed successfully 

CK 

083H 

Read OK after ECC 

DNR 

001H 

Drive not ready 

WPE 

002H 

Write-protection error 

CRC 

003H 

CRC or ECC error 

FMT 

004H 

Sector not found or disk format error 

EME 

005H 

Equipment malfunction error 

KXD 

006H 

Nonexistent drive 

NYI 

007H 

Function not yet implemented 

PGMR 

008H 

Programmer error 

DDR 

009H 

Drive dropped ready 

HUNG 

00AH 

Controller time out 

VERIFY 

00BH 

Verify error after write 

NODMA 

00CH 

No DMA channel available for transfer 
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7.9 INTERRUPT VECTOR USAGE 


The ranges for the interrupt vector usage are defined as follows: 


Value 


Description 


OCOH through OFFH 

08OH through OBFH 

040H through 07FH 

020H through 03FH 

014H through 01FH 

005H through 013H 

004H 

003H 

002H 

001H 

000H 


Reserved for programmer's use 
Reserved for the BIOS 
Not defined 

Reserved for the operating system 
Reserved for the INTEL 8087 emulator 
Reserved by INTEL 
Dedicated—Overflow interrupt 
Dedicated—1-byte INT instruction 
Dedicated—Nonmaskable interrupt 
Dedicated—Single-step interrupt 
Dedicated—Divide error interrupt 


7.10 ASYNCHRONOUS COMMUNICATIONS 


You can use the BIOS to trap input/output from the Wang PC serial 
communications controller I/O ports. When you set the input trap and a 
character is available for input, an interrupt is generated and control is 
passed to a user routine at the address specified when the trap is set. The 
user routine inputs the character from the serial input port and performs any 
associated error checking, XON/XOFF checking, and so on. 


You can enable the transmitter to generate an interrupt when the clear 
to send (CTS) signal is active and the transmitter is not currently sending a 
character. To enable the transmitter, set the transmit enable bit in the 
communications controller's command register. 

If you set an output trap, the transmit interrupt causes control to be 
passed to a routine at the address specified when the trap is set. This 
routine sends the character out to the serial output port when one is 
available and shuts off the transmitter when a character is not available. 

You must always disable the transmitter when characters are not available; 
otherwise, the system could be suspended as the transmit interrupt is 
generated repeatedly. 

To send a break, set the break bit in the command register to one and 
turn on the transmitter, and keep it on for the duration of the break. The 
system detects a break when the serial input port contains a zero and the 
status register indicates that a framing error has occurred. 
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NOTE: 

The communications controller requires two RS-232 signals to communicate with 
other devices: the clear to send (CTS) signal is required for the PC to 
transmit data and the data carrier detect (DCD) signal is required to receive 
data. 


There are no function calls at either the BIOS or the DOS level that 
allow you to set or modify the communications protocol and data transfer 
speed. You may set these by writing directly to the communications 
controller’s mode registers. 

For more detailed information on accessing the serial communication 
controller, refer to the Wang Professional Computer Technical Reference 
Manual. 


Example 

A segment of code is listed below as an example of how to use the BIOS 
interface for asynchronous communication. 


data 

segment 




out$byte 

db 

1 dup 

(?) 

; byte to be transmitted 

more$byte 

db 

1 dup 

(?) 

; flag used by serial 





output routine 

ser$input$qid 

dw 

1 dup 

(?) 

; serial input trap 





queue id 

ser$output$qid 

dw 

1 dup 

(?) 

; serial output trap 





queue id 

data 

ends 




stack 

segment stack 





dw 128 dup 

(?) 



stack 

ends 




code 

segment 





assume cs:code,ds:data,ss:stack 
set$traps proc near 
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; code to set serial port input character ready trap 


mov 

cx,0 

; set count to zero 

mov 

bx,01H 

; choose serial input 
as event to trap 

push 

ds 


mov 

ax,cs 

; make ds:dx point to 

mov 

ds, ax : ■•;'*'■■■■ 

; the serial input 



routine 

mov 

dx,offset ser$input 


mov 

al,02H 

; choose set event trap 
function 

int 

088H 

; set the trap 

pop 

ds 

mov 

ser$input$qid,bx 

; save trap QID 

; code to set 

serial port output character 

ready trap 

mov 

cx,0 

; set count to zero 

mov 

bx„02H 

; choose serial output 



as event to trap 

push 

ds 


mov 

ax,cs 

; make ds:dx point to 

mov 

ds,ax 

; the serial output 
routine 

mov 

dx,offset ser$output 


mov 

al,02H 

; choose set event trap 
function 

int 

088H 

; set the trap 

pop 

ds 


mov 

ser$output$qid,bx 

; save trap QID 

ret 



set$traps 

endp 



clear$traps 

proc near 



; code to clear 

serial port input character ready 

trap 

mov 

al,03H 


choose clear event 
trap function 

mov 

bx,s e r$input$qid 


put serial input trap 
qid in bx 

int 

88H 


clear trap 
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; code to clear serial port output character ready trap 


mov 

al,03H 

; choose clear event 
trap function 

mov 

bx,s er$output$qid 

; put output trap qid 
in bx 

int 

ret 

88H 

; clear trap 

clear$traps 

endp 


; serial input 

routine 


ser$input 

proc far 

; BIOS automatically 
saves registers 
except SS and SP 


ret 

ser$input endp 


ser$output proc far 


xmitSoff: 


done: ret 

ser$output endp 
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CHAPTER 8 

HARDWARE INTERFACE 


8.1 INTRODUCTION 


This chapter presents information for interfacing directly with PC system 
hardware. The hardware components covered include the screen, the 
standard Wang PC keyboard, and available Wang printers. 


8.2 SCREEN MANIPULATION 


The Wang BIOS recognizes a series of 1-byte control codes and 
ANSI-standard escape sequences that initiate specific screen operations. 
Section 8.2.1 lists the control codes, and Section 8.2.2 lists the escape 
sequences. 


8.2.1 Control Codes 


The BIOS recognizes the one-byte control codes listed in Table 8-1. 


Table 8-1. Screen Manipulation Control Codes 


Code 

Description 

07H 

08H 

09H 

OAH 

OCH 

ODH 

01BH 

Sound the tone 

Nondestructive backspace 

Cursor right (nondestructive) 

Line feed (scroll if necessary) 
Screen clear and cursor home 
Carriage return 

Enter Escape Sequence mode 
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{.2.2 Escape Code Sequences 


:he Wang PC keyboard does not include an escape key. Therefore, you must 
:reate escape code sequences to simulate the common uses of the escape 
cey. This section explains the various escape sequences and includes the 
•onnat of each sequence. Definitions of the parameters used in the 
sequence appear after the formats. Each sequence ends with an alphabetic 
:haracter that identifies the specific escape sequence. 

For all sequences, the parameters are ASCII-encoded decimal 
lumbers, containing the digits 0 through 9. The BIOS ignores all 
embedded blanks and control characters. The control code for entering 
Escape Sequence mode is 01BH. 

Use the escape code sequences within your programs to complete the 
following types of functions: setting graphic attributes, switching default 
screens, clearing the screen or line, moving the cursor, inserting lines, 
scrolling, and deleting. 

Portions of a BASIC program, a FORTRAN program, and a DOS session which 
complete the same action using escape code sequences follow. 

Example - BASIC program 

30 OPEN "cons: M FOR OUTPUT AS #1 

40 PRINT #1, CHR$(27);"[2J"; REM Clear screen 

50 PRINT #1, CHR$(27); ’'[7m"; REM Reversed video on 

60 PRINT #1, CHR$(27); M [12;27H"; REM Position cursor at row 12, 

column 27 

70 PRINT #1, "WANG Professional Computer" 

. 80 PRINT #1/ CHR$(27);"[0m" REM All attributes off 

Example - FORTRAN program 

WRITE (0,*(1X,A1,A)’)CHAR(27),'[2J' 

WRITE (0,*(1X,A1,A)')CHAR(27), 1 [7m’ 

WRITE (0,*(1X,A1,A)')CHAR(27),'[12;27HWANG Professional Computer' 

WRITE (0,'(IX,A1,A)')CHAR(27),'[OnT 
END 

DOS Batch Program 

A:COPY CON SCREEN 

T[[2JT[[7mT[[12;27HWANG Professional Computer![[0m 
TZ 


1 File(s) Copied 
A:TYPE SCREEN 
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rL“L^ r ^ diS ? layed J USt bSf0re 3 character indicates that the character 
E<?r !?h 1 ^ h ac „ er ‘ The control/left bracket sequence is equivalent to the 

P " ss C0,ra,0L * SHIFT + 1 *° «• contm! Tl 


The escape sequences are as follows: 


Sequence 


Action 


Produce subsequent output with selected attributes 


ESC M [ M p s M ;" 


where Ps specifies the graphic attribute. 
Values for Ps are in the following list.* 
The default is 0, or no attributes. 


Value Attribute 


0 

1 

2 

3 

4 

5 

6 

7 

8 

30 

31 

32 

33 

34 

35 

36 

37 

40 

41 

42 

43 

44 

45 

46 

47 


All attributes off 
Bold on 
Subscript on 
Superscript on 
Underscore on 
Blinking on 
Overscore on 
Reversed video on 
Concealed on 
Set Color 0 foreground 
Set Color 1 foreground 
Set Color 2 foreground 
Set Color 3 foreground 
Set Color 4 foreground 
Set Color 5 foreground 
Set Color 6 foreground 
Set Color 7 foreground 
Set Color 0 background 
Set Color 1 background 
Set Color 2 background 
Set Color 3 background 
Set Color 4 background 
Set Color 5 background 
Set Color 6 background 
Set Color 7 background 


is 
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Value 

Attribute 



50 

Set 

Color 

8 

foreground 

51 

Set 

Color 

9 

foreground 

52 

Set 

Color 

10 

foreground 

53 

Set 

Color 

11 

foreground 

54 

Set 

Color 

12 

foreground 

55 

Set 

Color 

13 

foreground 

56 

Set 

Color 

14 

foreground 

57 

Set 

Color 

15 

foreground 

60 

Set 

Color 

8 

background 

61 

Set 

Color 

9 

background 

62 

Set 

Color 

10 

background 

63 

Set 

Color 

11 

background 

64 

Set 

Color 

12 

background 

65 

Set 

Color 

13 

background 

66 

Set 

Color 

14 

background 

67 

Set 

Color 

15 

background 

80 

Set 

Color 

0 

highlight 

81 

Set 

Color 

1 

highlight 

82 

Set 

Color 

2 

highlight 

83 

Set 

Color 

3 

highlight 

84 

Set 

Color 

4 

highlight 

85 

Set 

Color 

5 

highlight 

86 

Set 

Color 

6 

highlight 

87 

Set 

Color 

7 

highlight 

88 

Set 

Color 

8 

highlight 

89 

Set 

Color 

9 

highlight 

90 

Set 

Color 

10 

highlight 

91 

Set 

Color 

11 

highlight 

92 

Set 

Color 

12 

highlight 

93 

Set 

Color 

13 

highlight 

94 

Set 

Color 

14 

: highlight 

95 

Set 

Color 

15 

i highlight 
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Set selected palette entry to have specified attributes 


ESC 7" Ps Pi Pr 

" Pg Pb "P" 


where Ps specifies the palette entry, for 
low resolution monitor only, at system 
startup (Ps values appear in the following 
list). Pi specifies the intensity, Pr 
specifies selection of red, Pg specifies 
selection of green, Pb specifies selection 
of blue. Use 0 to 7 to deselect red, green 
or blue, and use 8 to 15 to select red, 
green, or blue. Table 8—2 presents the 
resulting color from combinations of palette 
attributes. 


Value Color 

0 Black 

1 Dark gray 

2 White (light gray) 

3 White (for high intensity and bold) 

4 Blue 

5 Light blue 

6 Brown 

7 Yellow 

8 Green 

9 Light green 

10 Magenta 

11 Light magenta 

12 Cyan 

13 Light cyan 

14 Red 

15 Light red 


; 
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Table 8-2. Combinations of Palette Attributes 


Resulting Color 

Intensity 

Red 

Green 

Blue 

Black 

0* 

0 

0 

0 

Dark grey 

8* 

0 

0 

0 

White (light gray) 

0 

8 

8 

8 

White 

8 

8 

8 

8 

Blue 

0 

0 

0 

8 

Light blue 

8 

0 

0 

8 

Brown 

0 

8 

8 

0 

Yellow 

8 

8 

8 

0 

Green 

0 

0 

8 

0 

Light green 

8 

0 

8 

0 

Magenta 

0 

8 

0 

8 

Light magenta 

8 

8 

0 

8 

Cyan 

0 

0 

8 

8 

Light cyan 

8 

0 

8 

8 

Red 

0 

8 

0 

0 

Light red 

8 

8 

0 

0 


*You can substitute any value from 0 to 7 for any 0 entry in this 
table, and you can substitute any value from 8 to 15 for any 8 
entry in this table. 

Select the specified screen as the default screen 

ESC "/" Ps "s M where Ps = 1 specifies the first screen and Ps 

= 2 specifies the second screen, etc. If the 
specified screen is not found, the current 
default screen remains selected. 
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Set or clear selected screen attribute modes 


ESC "[ M Ps ":» 


Ps "h" 


" 1 ’ 


h” 


where Ps specifies screen and LED mode 
sets the selected mode; 

1 clears the mode. The values for the 
modes appear in the following list The 
default is 0. Only 80-column monitors allow 
a choice of 40 or 80 characters per line. 

In 80-column mode. 4 colors can be displayed 
simultaneously. In 40-column mode, up to*16 
colors can be displayed simultaneously. 


Value Mode 


2 Cursor Blink 

3 Cursor Block 

4 Insert—While Insert mode is active, 
printed characters are inserted at the 
cursor position. 

5 Cursor On/Off-” 1" sets the cursor on; 
M h" turns the cursor off. 

6 Soft scroll (low-resolution card only) 

7 40/80-column (low-resolution card 
only) "h" selects 80-column mode; "i" 
selects 40-column mode. 

8 Cursor attach—When the mode is set, 
the cursor moves with character output; 
when the mode is clear, the cursor 
stays at its current location. 

9 End-of-line autowrap—When the mode is 
set, a right cursor movement from the 
right margin moves down to the left 
margin on the next line; when the mode 
is clear, the last character of a line 
is overwritten. 


11 

Control 

LED 

12 

Control 

LED 

13 

Control 

LED 

14 

Control 

LED 

15 

Control 

LED 


) 
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lear selected portions of screen 

SC "[" Ps M J" where Ps specifies the portion of the screen 

to clear. The values for Ps appear in the 
following list; the default is 0. 

Value Action 


0 Erase from cursor to end of screen 
(including character at cursor). 

1 Erase from start of screen to cursor. 

2 Erase entire screen and move the cursor 
to the home position. 

lear selected portions of line 

SC Ps "R" where Ps specifies the portion of the line 

to erase. The values for Ps appear in the 
following list; the default is 0. 

Value Action 

0 Erase from cursor to end of line 
(including character at cursor). 

1 Erase from start of line to cursor. 

2 Erase entire line and position cursor 
to column one of that line. 

osition the cursor at a specified row and column 

SC "[" Pr Pc "H” where Pr specifies a number from 1 to 25 

"f" designating a row (the default is 1). Pc 

specifies a number from 1 to 40 or 1 to 80, 
depending on the width of the screen, 
designating a column (the default is 1). 

"H" and "f" have the same results. 

ove the cursor in a specified direction for a specified number or rows or 
olumns 

"A" 

" B » 

SC M [" Pn M C" where Pn specifies the number of rows or 

"D" columns that the cursor will move, the 

default is 1. "A” moves the cursor up, ’'B M 

moves the cursor down, "C" moves the cursor 
right, and "D" moves the cursor left. 
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\ 


p os ition CUrrent CUrSQr p osition Qr restore the cursor to a previously 


where "s" saves the current cursor position, 
and "u" restores the cursor to the 
previously saved position. If you use a 
second save sequence before you restore the 
cursor to the previously saved position, the 
second save sequence overwrites the 
information from the first sequence. 


I nsert a jgecified number o f lines at the current cursor line 


where Pn specifies the number of lines to be 
inserted; the default is 1. Ps specifies 
which part of the screen moves. If Ps is o 
(the default), the lower part of the screen 
moves down. If p s is any nonzero number, 
the upper part of the screen moves up. 


D elete a specified number o f lines beginning at the current cursor line 


ESC Pn " Ps "M" 


where Pn specifies the number of lines to 
delete/ the default is 1. Ps specifies 
which part of the screen moves. If Ps is 0 
(the default), the lower part of the screen 
moves down. If Ps is any nonzero number, 
the upper part of the screen moves up. 


Dele te specified number of characters 
cursor position ~ ■' 


in current line starting at the current 


ESC M [" Pn "P" 


where Pn specifies the number of characters 
to delete. 


S croll a specified portion of the screen up or down a specified number of lines 


ESC "/" Ps Pe 

" Pc Pd "S" 


where Ps specifies the line number where 
scrolling starts and must be less than Pe 
(no default). Pe specifies the ending line 
number of the lines to be scrolled (no 
default). Pc specifies the number of lines 
to scroll the specified portion of the 
screen (default is 1). Pd specifies 
direction of scroll. 0 (the default) 
scrolls down; any nonzero number scrolls 
up. 
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Reset the default screen to the startup configuration 


ESC "z 


Screen reset to 80-column mode, 
and blinking, screen is cleared, 
is at Row 1, Column 1. 


Cursor 
and curs 




Move (copy) a window on the screen 


ESC "/" Psr Psc "; M Prc 

Pec Pdr Pdc M M'* where the Pxx variables specify the size of 

the rectangle to be copied and the 
destination position. Psr specifies the 
starting row position. Psc specifies the 
starting column position. Prc specifies the 
height of the rectangle (in rows). Pcc 
specifies the width of the rectangle (in 
columns). Pdr specifies the destination row 
position. Pdc specifies the destination 
column position. There are no default 
values. 


Erase a window on the screen 


ESC "/" Psr Psc "; M 

Prc Pcc "E" 


where the Pxx variables specify the 
rectangle area to be erased: Psr specifies 
the starting row position; Psc specifies the 
starting column position; Prc specifies th^ 
height, in rows; and Pcc specifies the ™ 
width, in columns. 


Display characters in image mode 

ESC "/” Pc ... "; M Pc "I” Some characters, if interpreted directly by 

the BIOS, do not display on the screen 
unless you use this escape sequence. For 
example, 13 would be interpreted by the BIOS 
as a carriage return. With the escape 
sequence, ESC "/13I", it is interpreted 
correctly, and the character at font 
position 13 (ODh) appears on the screen. 

This sequence is necessary for printing 
characters in the Positions Olh through OFh. 
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8.3 LOGICAL KEYBOARD PROTOCOL 


This section explains the logical keystrokes available to all application 
programs that run on the Wang PC. Logical keystrokes are independent of 
the different physical keyboards available with the Wang PC. The 
BIOS.SYS file contains tables for translating the codes received from a 
specific physical kevboard into the logical keystrokes described in this 
section. Therefore, the specifications presented in the following tables 
are valid for all languages for which the Wang PC supplies keyboards. 

There are three categories of logical keystrokes: simple 
characters, special characters, and dead keys. 16-bit codes define the 
keystrokes. For simple characters, the high-order byte is OOh; for dead 
keys, it is 1EH, and for special characters, it is 1FH. The system 
stores the high-order byte first, but does not send an OOH byte to the 
keyboard buffer. When an application retrieves a keystroke, therefore, 
it may need to retrieve one byte or it may need to retrieve two bytes. 

The application should check the first byte retrieved for 1EH or 1FH. If 
the byte is 1EH or 1FH, the next byte specifies which special key or dead 
key sequence was struck. A valid keystroke never has a low-order byte of 
OOH, 1EH, or 1FH. 


s 

1 

i 


Because a data stream representing logical keystrokes may come from 
a device other than the keyboard, your program should accept the data 
stream with or without the OOH bytes. This enables any program that 
uilds a keystroke stream to create all 16-bit codes without deleting 
ul Is. 


8.3.1 Simple Characters 


; :j i i > - . r v 

Simple^characters include the printable, WISCII I character set from 20H (?: 
to FFH and control characters between 01H and 1BH. The high-order byte 
is OOH. There are no exceptions for rubout or erase line, and the 
high-order bit is always significant. 

The WISCII I Character Set 

Table 8-3 lists the standard (nonscientific) WISCII I character set from 
2OH to FEH. 
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Table 8-3. The WISCII I Character Set (continued) 


Decimal 

Hex 

Character 

Explanation 

115 

73 

s 

s 

116 

74 

t 

t 

117 

75 

u 

u 

118 

76 

V 

V 

119 

77 

w 

w 

120 

78 

X 

X 

121 

79 

y 

y 

122 

7A 

z 

z 

123 

7B 

[ 

Left brace 

124 

7C 

1 

Vertical bar 

125 

7D 

) 

Right brace 

126 

7E 

— 

Approximate symbol 

127 

7F 

c 

Cent sign 

128 

80 

o 

Degree sign 

129 

81 

♦ 

Center graphic 

130 

82 

► 

Tab graphic 

131 

83 

◄ 

Return graphic 

132 

84 

—* 

Indent graphic 

133 

85 

1— 

Decimal tabulation graphic 

134 

86 

1 

Format graphic 

135 

87 

■ 

Stop graphic 

136 

88 

j! 

Note graphic A 

137 

89 

I 

Merge graphic S 

138 

8A 

1 

Down arrow ^ 

139 

8B 

I 

Up arrow 

140 

8C 

*— 

Left arrow 

1 141 

8D 

± 

Plus-or-minus sign 

142 

8E 

i 

Inverted exclamation point 

143 

8F 

i 

Inverted question mark 

144 

90 

A 

A circumflex 

145 

91 

A 

A grave 

146 

92 

A 

A acute 

147 

93 

A 

A umlaut 

148 

94 

A 

A tilde 

149 

95 

o 

Left arrow 

150 

96 

A 

A angstrom 

151 

97 

1 

Down arrow 

152 

98 


Ligature AE 

153 

99 

C 

C cedilla 

154 

9A 

i 

Double dagger 

155 

9B 

m 

Bullet 
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Table 8-3. The WISCII I Character Set (continued) 


Decimal 

Hex 

Character 

156 

9C 

E 

157 

9D 

E 

158 

9E 

E 

159 

9F 

E 

160 

AO 

a 

161 

A1 

a 

162 

A2 

a 

163 

A3 

a 

164 

A4 

a 

165 

A5 


166 

A6 

o 

a 

167 

A7 


168 

A8 

ae 

169 

A9 

c 

170 

AA 

a 

171 

AB 


172 

AC 

e 

173 

AD 

e 

174 

AE 

e 

175 

AF 

e 

176 

BO 

G 

177 

B1 

U 

178 

B2 

1 

179 

B3 

1 

180 

B4 

j 

181 

B5 

1 

182 

B6 

j 

183 

B7 

L* L 

184 

B8 

N 

185 

B9 

6 

186 

BA 

6 

187 

BB 

V 

0 

188 

BC 

o 

189 

BD 

6 

190 

BE 

(E 

191 

BF 

0 


CO 

g 

193 

Cl 

ij 

194 

C2 

i 

195 

C3 

? 

196 

C4 

i 

197 

C5 



Explanation 


E circumflex 
E grave 
E acute 
E umlaut 
a circumflex 
a grave 
a acute 
a umlaut 
a tilde 
Right arrow 
a angstrom 
Dagger 
Ligature ae 
c cedilla 
Ballot box 
Required space 
e circumflex 
e grave 
e acute 
e umlaut 
G hacek 
1J ligature 
Dotted I 
I circumflex 
I grave 
I acute 
I umlaut 

Catalonian LL ligature 
N tilde 

0 circumflex 
0 grave 
0 acute 
0 umlaut 
0 tilde 
OE ligature 
Slashed 0 
g hacek 
ij ligature 
Dotless i 
i circumflex 
igrave 
i acute 
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Table 8-3. The WISCII I Character Set (continued) 


Decimal 


Hex 


Character 


Explanation 


237 

ED 

» 

238 

EE 

a 

239 

EF 


240 

FO 

£ 

241 

FI 

/ 

242 

F2 

¥ 

243 

F3 

'A 

244 

F4 

'/> 

245 

F5 

% 

246 

F6 

* 

247 

F7 


248 

F8 

' 

249 

F9 


250 

FA 


251 

FB 


252 

FC 


253 

FD 


254 

FE 



European close quotes 
Beta 

Centered dot 
Pound sterling 
Florin 
Yen 
1/4 
1/2 
3/4 

Accent circumflex 
Accent grave 
Accent acute 
Accent umlaut (diaeresis) 
Accent tilde 
Accent cedilla 
Accent hacek 
Accent breve 
Dotted Space 


Hardware Interface 




8-18 


8.3.2 Control Characters 

To generate control characters, press CONTROL and another key simultaneously. 
The same control character results whether the other key is shifted or 
unshifted, except for CONTROL + [, where [ must be shifted. Table 8-4 
contains the control characters from 01H to 1BH. 


Table 8-4. Control Characters 


Hex Value 

Keystroke Sequence 

01 

CONTROL + A 

02 

CONTROL + B 

03 

CONTROL + C or SHIFT + CANCEL 

04 

CONTROL + D 

05 

CONTROL + E 

06 

CONTROL + F 

07 

CONTROL + G 

08 

CONTROL + H or BACKSPACE 

09 

CONTROL + I or TAB 

0A 

CONTROL + J 

0B 

CONTROL + K 

0C 

CONTROL + L 

0D 

CONTROL + M or RETURN 

0E 

CONTROL + N 

OF 

CONTROL + 0 

10 

CONTROL + P 

11 

CONTROL + Q 

12 

CONTROL + R 

13 

CONTROL + S 

14 

CONTROL + T 

15 

CONTROL + U 

16 

CONTROL + V 

17 

CONTROL + W 

18 

CONTROL + X 

19 

CONTROL + Y 

1A 

CONTROL + Z 

IB 

CONTROL + [ 


Hardware Interface 




3-19 



8.3.2 Special Characters 


pecial characters include various codes such as function keys, cursor control 
keys, ERASE, HELP, CANCEL, and PRINT. Note, however, that SHIFT, CAPS LOCK, 
CONTROL, and 2ND have no codes assigned to them. For special characters, the 
high-order byte is 1FH. 

sfcu-j-.j k/;~> 

There are 64 possible logical function keys with codes 1F80H to 1FBF. 

Of these, only the first 32 function keys, 1F80H to 1F9FH, are defined. Codes 
1F61H to 1F7AH are undefined and you can use these for specific applications^ 
Table 8-5 contains the remaining special characters with their shifted and 
unshifted hex values. 


Table 8-5. Special Character Keys 


Key 

Unshifted 

Shifted 

Cancel 

1FE0 

0003 

Help 

1FE1 

1FF1 

Glossary 

1FE2 

1FF2 

Print 

1FE3 

1FF3 

North cursor 

1FC0 

1FD0 

South cursor 

1FC2 

1FD2 

East cursor 

1FC1 

1FD1 

West cursor 

1FC3 

1FD3 

Home 

1FC4 

1FD4 

Execute 

1FC5 

1FD5 

Insert 

1FC6 

1FD6 

Delete 

1FC7 

1FD7 

Previous 

1FC8 

1FD8 

Next 

1FC9 

1FD9 

Erase 

1FCB 

1FDB 

Tab 

0009 

1FDC 

Backtab 

1FCD 

1FDD 


8.3.3 Dead Keys 


Dead key sequences are keystrokes that combine with one or more other 
keystrokes to produce one printable character. The high-order byte is 1EH 
Dead key codes are between 1E20H and 1EFFH. These are intermediate codes. 
The system replaces the intermediate codes with the code for the combined 
keystrokes when you press the final key in the sequence. 
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The restart key sequence exemplifies the use of dead keys. 2ND + 

COMMAND produces an intermediate 1EH code. The system replaces the 
intermediate code with the code for restart when you press CANCEL. If you 
enter an invalid dead key sequence, the code of the last nondead key you press 
is what the keyboard buffer receives. 

A keyboard must be in one of two dead key modes: Visible mode or 
Invisible mode. When you press dead keys in Visible mode, codes corresponding 
to the keys are put into the buffer. The code can have a printable graphic 
associated with it. If there is no graphic, a dead key blank is placed into 
the buffer. When you press dead keys in the Invisible mode, the operating 
system receives the codes, but does not store them in the buffer. The only 
code the buffer receives is the combined code generated when you press the 
final key in the dead key sequence. The default keyboard mode for dead keys 
is Invisible. 


8.3.4 The Physical Keyboard 


The Universal Wang Keyboard has an 8-bit bidirectional serial interface. The 
bytes sent by this interface were chosen as a superset of the existing Wang 
keyboards' internal or X-Y codes. Thus, the codes have no relation to the 
keyboard electrical hardware, the user function, or the WISCII codes. This 
mechanism allows for different interpretations of the keystrokes according to 
the individual needs of each country. 

The output channel of the keyboard interface controls the audio (beep, 
click, and other sounds), display of the LEDs on the keyboard, and the trigger 
status and diagnostic routines. 

The BIOS receives bytes from the serial interface, interprets them 
according to tables, and usually stores the 2-byte WISCII-translated code in a 
FIFO. The BIOS uses the 2-byte form so that the number of logical characters 
in the buffer can be known and to ensure that buffer flushing is safe from 
race conditions. An application program calls DOS once or twice to get each 
logical character. 

Not all physical keystrokes map one-to-one onto logical keystrokes. For 
example, if a terminal existed that did not have a cursor pad and an 
application program required cursor keys, the program could define the tables 
to create the logical keystroke from multiple physical keys. Similarly, just 
as uppercase characters require two keys, so do control codes. Finally, 
programs can use the keyboard to communicate directly to the operating system 
without interfering with the application (e.g., the screen dump feature). A 
single key could generate more than one logical character (e.g., languages 
where one character, or keystroke, requires two columns on the printed page). 
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8.3.5 


Sample Keyboard Description 


because the keyboard software is table-driven, there can be 
variations on what can be done with the physical keyboard, 
presents one sample physical keyboard for the USA. 


numerous 
This section 


The BIOS keeps a table of flags 
shift bits. 


indicating.the current state of several 


• SHIFT 

• CAPS LOCK 

• CONTROL 

• 2ND 


s H I FT, CONTROL, and 2ND are level signals because the software keeps track of 
whether they are depressed and interprets each keycode accordingly. CAPS LOCK 
^ toggle switch; each time you press it, it complements the CAPS LOCK 
statyr and the LED indicating if CAPS LOCK is on or not is changed 

™ o“S 9 Firo" e keys *" not p “* ° f the FIF0 - they af£ *« “<•« 




NOTE: 

Unlike the CAPS LOCK key, which does not require a continuous press to create 

the C0NTR ° L kSy 2N ° k6y mUSt be prSSSed before each 


When you enter an English letter from A to Z, the resulting case of the 

reverf 6 th PendS ° n *° R ° f the CAPS L0CK and SHIFT keys. The logic to 
everse the case is driven from a table, not an XOR of 20. When you^nter 

other standard characters, the shifted forms result regardless o/cAPS LOCK 

For sc. keys, such ss EXECUTE, both shifted .„d uushiltld »!blt 

h S 'k F ° r the standard USA keyboard, no distinction is made between the 

orthI S a ? b h V K alphabetic ke y s and the numbers on the keypad to the right 

lSck bJj tSev do JT : ThS “ NTR ° L and 2ND keys ^e status of CaIs 

luck, but they do not ignore the status of each other. 

wherebv f an°aooH^ SHIFT COntro1 passes though a defined vector 

closed application is terminated, buffers are flushed, and files are 


a second T F ^ f ° r more than approximately one-third of 

inhibit this L^ f repeats until keyboard buffer fills up. You can 
inhibit this action for specified keys by modifying the tables. 

storerf^H the keyboard buffer is f “ll, additional keystrokes are not 
stored. However, you can switch CAPS LOCK even if the buffer is full. 
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3.4 PRINTER DRIVERS 


-is section provides information on the Wang Generalized Printer Drivers 
:~:FD) and the dedicated printer driver for the Wang Model PM011 printer. The 
section includes the control codes and escape sequences for the printer 
drivers. 


8.4.1 Generalized Printer Drivers 


There are three GPDs: a parallel device driver, PAR1DRVR.COM, a serial device 
driver, SER1DRVR.COM, and a multi-communications controller (MCC), MCCDRVR.COM. 

A GPD provides the interface between the application and printer 
firmware. The printer function table is flexible enough so that the GPD can 
support most printers, regardless of varying printer escape sequences and 
methods. However, the driver is general, not universal, and not every printer 
can be fully supported. 

The GPD can drive any ASCII character or line printer providing the 
printer supports the following features: 

• A Centronics type parallel or serial RS-232-C hardware interface 

• DC1/DC3 (llh/13h) protocol for serial printers 

• LP (OAh), FF (OCh) and CR (ODh) control codes 

• A dip switch which can disable auto line feed 

• Setting a 24-lines-per-inch increment used for subscript, 
superscript, and double underscore attributes (double underscore 
defaults to a 1/48 inch increment if supported) 

The GPD is a table-driven driver that processes one complete line at a time. 
Processing requires making multiple passes of the buffered line, while dumping 
data to the output buffer with a time-sliced technique. 

The GPD intercepts each byte of data from the application and 
interrogates it to determine whether it is a printable character, a control 
code, or part of an escape sequence. For printable characters, the driver 
buffers one complete line of characters before processing. The number of 
passes required to print a line depends on the attributes and character 
overstrikes set. To bypass this action, you can place the driver in 
Transparent mode, in which it passes all input data directly to the output 
buffer without interrogation. Transparent mode is useful for graphics and 
other applications that require direct printer communications. 
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A Desktop mode of operation is available for driving the 8" n i^»n 
>nt*r. The following tablc sbm , th . lin , 

Ch ,CP1> f ° r the ais “ <* »»«« pointers: 




8 M 

Platen 

13.2" 

Platen 

cpi 

40 

cpi 

66 

cpi 

cpi 

80 

cpi 

132 

cpi 

cpi 

96 

cpi 

158 

cp 1 

cpi 

120 

cpi 

198 

cpi 

cpi 

132 

cpi 

217 

cpi 


Power-on Defaults 

The GPD uses the following power-on defaults: 

• 10 pitch 

• 6 lines per inch 

• One horizontal tab every eighth character 

• No attributes enabled 

• No inodes enabled 

carriage 6 rSturn er be S6t t0 disable auto line «»«d after 


Loading Drivers 



specify which printer 
flows: 


driver(s) 


you are using. 


you must edit CONFIG.SYS as 


DEVICE = /PAR1DRVR.COM 
DEVICE = /SER1DRVR.COM 
DEVICE = /MCCDRVR.COM -s %ppp 


Refer to The Wang 
description of how 


Professional Co m puter Introductory Guide for 
to load the drivers. 


a complete 


WARNING: 

If you modify CONFIG.SYS, be verv careful T f » , 

be able to start your system Always keen hllj “2 k ! u a mistake ' ^ ou ma Y not 
syste. disks, including th. iriginj COKTO Sys“ P * 0r *3‘“ 1 


on. t.'T lh % Sl0t nU,a> " <* * which 

and uses the first card it find<? T >, n G f 1S s P ec *fi ed ' the driver searches 
«h* posts for Si SSS ti SS 0 ™* PO £ «p ■ 1. « « 31 specify 

driver takes over all three° 3 6 ° Ver * If n ° P ° rt numbers are specified, the 


The MCC driver supports shared devi< 
needed for every MCC card used: 


memory (SDM). 


A SDM driver is 


DEVICE = /TPMS23S1.TTY -s 
DEVICE = /TPMS23S2.TTY -s 


(s = Slots 1-8> 
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The slot numbers are necessary when using multiple MCC cards. These SDM 
drivers must be placed before the MCC driver in the CONFIG.SYS file. 

At boot time, the device drivers are loaded, and a message identifying 
which is being loaded appears on the screen. Then, the driver loads the 
appropriate printer function and character translate tables. By default, 
printer output is directed to the parallel port. However, MENUDRVR redirects 
printer output to the serial port if the serial driver is loaded. 

The Printer Redirection utility (RDIR.EXE) redirects to the different 

ports: 


Command Line 

RDIR 4 /DEV/PRN 
RDIR 4 /DEV/PRN1 
RDIR 4 /DEV/PRN2 
RDIR 4 /DEV/PRN3 
RDIR 4 /DEV/PRN4 


Port 

CPU Parallel port 
CPU Serial port 
MCC Bottom port #1 
MCC Middle port #2 
MCC Top port #3 


Loading Printer Function Tables and Character Translate Tables 

The GPD automatically loads the Index Table (PRNXLT.COM), which specifies the 
Printer Function Table (.PDT) and possibly the Character Translate Table 
<.CTT) to load at boot time. Refer to The Wang Professional Computer 
Introductory Guide for details on modifying printer tables using the Printer 
Table Editor utilities. The Index Table is 256 bytes structured as follows: 


OOh-OBh 

(OCh-OEh unused) 

(OFh reserved) 

#1 

PDT 

file 

name 

(PRN) 

lOh-lBh 

(ICh-lFh unused) 

#2 

PDT 

m 

" 

(PRN1) 

20h-2Bh 

(2Ch-2Fh unused) 

#3 

PDT 

H 

ii 

(PRN2) 

30h-3Bh 

(3Ch-3Fh unused) 

#4 

PDT 

11 

ii 

(PRN3) 

40h-4Bh 

(4Ch-4Fh unused) 

#1 

CTT 

•• 

•• 


50h-5Bh 

(5Ch-5Fh unused) 

#2 

CTT 

m 

H 


60h-6Bh 

(6Ch-6Fh unused) 

#3 

CTT 

" 

H 


70h-7Bh 

7Ch-7Fh 

OOh = do not load CTT 
Olh = load CTT 

#4 

CTT 

H 



80h-8Bh 

(8Ch-8Fh unused) 

#5 

PDT 

file 

name 

(PRN4) 

90h-9Bh 

(9Ch-9Fh unused) 

#6 

PDT 

" 

" 

(reserved) 

AOh-ABh 

(ACh-AFh unused) 

#7 

PDT 

H 

H 

(reserved) 

BOh-BBh 

(BCh-BFh unused) 

#8 

PDT 

ii 

ii 

(reserved) 

COh-CBh 

(CCh-CFh unused) 

#5 

CTT 

ii 

♦♦ 


DOh-DBh 

(DCh-DFh unused) 

#6 

CTT 

H 

H 


EOh-EBh 

(ECh-EFh unused) 

#7 

CTT 

ii 

•i 


FOh-FBh 


#8 

CTT 

H 

M 



FCh-FFh OOh = do not load CTT 
Olh = load CTT 
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At boot time, the PRN driver loads Printer Function Table #1, the PRNi 
driver loads Printer Function Table #2, and so on. If Byte 7Ch equals Olh 

«™, d ^ 1Ver l0adS Character Translate Table #1. If Byte 7Dh equals Olh' 
the PRNI driver loads Character Translate Table #2, and so. 

Printer Function Table 

The Printer Table is a .PDT file. The table is 512 bytes long from which the 
driver determines what defaults, control codes, and escape sequences are 

supported by a particular printer. The table is structured into three blocks 

as follows: 


BLOCK I Boot Time Defaults 
BLOCK II Miscellaneous 
BLOCK III Escape Sequences 


The descriptions of these blocks use the following terms: 


Function 


Terminator 


OTE: 
The T< 


String of printer codes defining an escape sequence 
or control codes. 

The point where the driver stops accessing the table 
for additional printer codes. The terminator is 
represented by a hex FE. The terminator must be 
present for any unsupported function or data string. 


The Terminator Code FEh cannot be embedded within an escape sequence. 


. K f° r j e !* Ch functlon ' insert all printer codes up to and not including any 

Tunderl " * e ™ lnate the fun =tion string, then insert the variable data 
(underlined), and terminate the data string. 
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The descriptions of the Printer Table's blocks follow. 


Block I—Boot Time Defaults 


OOOh 

OOlh 

002h 

003h 

OO4h-00Fh 

baud rate 

data bits 

parity 

stop bits 

reserved 


01h=50 

01h=5 

01h=none 

01h=l 

02h=75 

02h=6 

02h=odd 

02h=l.5 

03h=100 

03h=7 

03h=even 

03h=2 

04h=110 

04h=8 


05h=134.5 

05h=9 




06h=150 

07h=200 

08h=300 

09h=600 

0Ah=1200 

0Bh=1800 

OCh=2400 

0Dh=3600 

OEh=4800 

0Fh=7200 

10h=9600 

Ilh=16K 

12h=19200 

13h=56K 

14h=l.344M 

15h=l.544M 


Serial options required for SERIAL DRIVERS ONLY. 

Some serial options are not available for every port. 


OlOh 

Ollh 

012h 

013h 

desktop mode 

transparent mode 

sheet feeder 

standard mode 

+- 

OOh = not supported - 

Olh = supported 



014h 015h-01Fh 


idle mask 


reserved 


masks off all 
printer status 


bits except for 
printer idle. 

For Standard mode only. 
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Block II—Miscellaneous 


020h 


02 8h 


030h 


function-terminator 


function-terminator 


function-terminator 


Sound Audible tone Status Request Deselect Printer 

+-for Standard mode only-+ 


38h 


040h—05FH 


function-terminator 


reserved 


Reset Printer 


Standard mode is available for serial drivers only . It can only be 
enabled if printer firmware supports status request and deselect printer 
escape sequences. The status request function must be three bytes, not 
including the terminator. The status byte returned must be preceded by STX 
(02h), and the printer idle status bit is as follows: 


0=busy 

l=idle 

the Deselect function must be preceded by a DC3 <13h) code. Also the printer 
'firmware must return an XOFF upon receiving the Deselect sequence. 

For serial drivers only and if the printer issues an XON after reset, 
the Reset function must be followed by a DC1 (llh) code. It is recommended 
that the Reset Printer function be omitted for serial printers that do not 
issue an XON after reset. 


Horizontal tab stops are supported at every eighth character position, 
except for proportional spacing where they are not supported. The driver 
steps the carriage out to the correct tab boundary, emulating the horizontal 
tab control code. Vertical tabs are not supported because accurate emulation 
is impossible when platen movement can also be controlled by the printer 
control panel. 

Left margins are supported for half and full inch intervals. The driver 
steps the carriage out to the correct margin boundary, emulating the set left 
margin escape sequence. 


Hardware Interface 






8-28 



+-Set Line Feed Spacing-+ 

OCOh OC8h ODOh OD8h OEOh 



OFOh 0F8h lOOh 108h llOh 



+-Set Horizontal Spacing-+ 

118h 120h 128h 


proportional on proportional off function-terminator 

+-Set Horizontal Spacing---+ 

138h 140h 148h 150h 158h 160h 168h 170h 

1 inch 2 inch 3 inch 4 inch 5 inch 6 inch 7 inch 8 inch 




- Set Form Length - 




178h 

180h 

188h 190h 

198h 

lAOh 

lA8h 


9 inch 10 inch 11 inch 12 inch 13 inch 14 inch 15 inch 
+-Set Form Length-+ 

function-terminator 
+-Set Form Length-+ 

For proportional spacing,, no attributes, justification, or column 
alignment is supported. 
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The following are the thousandths of an inch increments that convert to 
the indicated escape sequence function values: 

get .Line Feed Spacing LiMCS PH ft |MCH ; i PC 
Increments Value 


0 

. 0 

lpi* (suppresses LF) 

1-30 

48 

Ipi (used for double %B- 6.D20 

underscore increment 

only) 

31-61 

24 

lpi l/a^=.04! 

62-124 

12 

lpi V/2 =.083 

125-165 

8 

lpi '/s =0,125 

166-248 

6 

lpi '\S -o.l t>lo 

249-331 

4 

lpi '/A- =0-2 TO 

332-497 

3 

lpi '/3 - C. 333 

498 and above 

2 

lpi Vz - 6. Sec 


Set. Horizontal Spacing c HAtfACTHRS PH ft I ; C Pi 


Increments 


Value 


0-59 

proportional 


60-65 

16. 

5 ipiCpc 

1 h& s - o.otoo 

66-82 

15 

dpt 

'/is =0,066 

83-99 

12 

IpirCpt 

'/l2 = 0.0 83 

100-199 

10 

±P±Cf>i 

l/io =O.IO o 

200 and above 

5 

lpi CPC 

I/s =0.20G 

Set Form Length 




Increments 

Value 


0-1499 

1 

inch 


1500-2499 

2 

inch 


2500-3499 

3 

inch 


3500-4499 

4 

inch 


4500-5499 

5 

inch 


5500-6499 

6 

inch 


6500-7499 

7 

inch 


7500-8499 

8 

inch 


8500-9499 

9 

inch 


9500-10499 

10 

inch 


10500-11499 

11 

inch 


11500-12499 

12 

inch 


12500-13499 

13 

inch 


13500-14499 

14 

inch 


14500-above 

15 

inch 



Set Horizontal Spacing, Line Feed Spacing, and Left Margin escape 
sequences should only be issued between lines. The Set Form Length escape 
equence should be issued between pages. 
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ICOh lC8h lDOh 

_i_!- 

function-terminator ! function-terminator ! function-terminator 

_i_!- 

Configure Feeder Select Bin Clear Platen 


lD8h-lFFh 


Reserved 

The Configure Feeder and Select Bin escape sequences must be multi-byte 
sequences where the variable data string is one byte trailing the function 
string. Only the function string is table-driven. The variable data byte is 
sent by the driver and has the following format: 

Configure Feeder Sequence: 

The most significant four bits are defined as: 

0001 Bin 1 
0010 Bin 2 
0011 Envelope bin 

The least significant four bits are defined as: 

0000 8.5 x 11 portrait 

0001 8.5 x 11 landscape 

0010 8.5 x 13 portrait 

0011 8.5 x 14 portrait 

0100 8.5 x 10.5 portrait 

0101 210mm x 297mm (A4) portrait 

0110 210mm x 297mm (A4) landscape 

0111 7.25 x 10.5 portrait 

1000 #10 envelope 

1001 European envelope 

Select Bin Sequence: 

An ASCII byte defined as: 

31h Select Bin 1 
32h Select Bin 2 
33h Select Envelope Bin 

Character Translate Table 

The Character Translate Table is a .CTT file. The table is 512 bytes long and 
is used to relocate PC WISCII character positions to where they are found in a 
particular printer table. Also, the table supports ESC (lBh) code characters, 
single and double overstruck characters, and SO (0Eh)/SI (OFh) character 
access. The table is structured as follows: 
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Byte OCOh 




Bytes OOlh-OOFh 


Bytes OlOh-OlFh 
Bytes 020h-0FFh 



ytes lOOh-lOFh 


Bytes HOh-llFh 


Bytes 120h-lFFh 


Used as a flag to indicate whether or not SO/SI 
character access is supported: 

00h=not supported 
01h=supported 

When supporting SO/SI character access, those characters 
must be put into the table with the,hi-order D7 bit 
(80h) set. When printing these characters, the driver 
first sends the SO (OEh) code, strips off the D7 bit, 
and then sends the character followed by the SI (OFh) 
code. 

Used for ESC code character support. The value of each 
byte is a WISCII character representing the second byte 
of the ESC code character sequence. If any byte Olh-OFh 
(table offset) appears in the WISCII table, that 
character is considered an ESC code character. An ESC 
code character is printed by sending the ESC (lBh) code 
followed by the second byte located at the table offset. 

Reserved. 

Represent the PC WISCII character set. The value for 
each byte represents the location of the base character 
in a particular printer table. 

Represent the primary overstrike offsets (Byte lOOh not 
used). The- value for each byte represents the location 
in the PC WISCII character set of the overstrike 
character. 

Represent the secondary overstrike offsets (Byte IlOh 
not used). The value for each byte represents the 
location in th PC WISCII character set of the overstrike 
character. 

Represents whether a character is overstruck. The value 
for each byte represents whether or not the associated 
base character is overstruck. The bits for each byte 
are defined as follows: 

D0-D3 Indicate the location in the primary row of 
the table of the overstrike offset. A value 
of zero indicates no overstrike. 

D4-D7 Indicate the location in the secondary row 
of the table of the overstrike offset. A 
value of zero indicates no overstrike. 
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Printer Driver Protocol 

The following sections explain the control codes and escape sequences 
supported by the GPD. 

Control Codes 

The GPD recognizes the following one-byte control codes: 


Code 

Function 


07h 

Sound the audible 

tone 

09h 

Horizontal tab 


OAh 

Line feed 


OCh 

Form feed 


ODh 

Carriage return 


OlBh 

Enter Escape (ESC) 

Sequence mode 


Escape Code Sequences 

This section explains the various escape code sequence for the generalized 
printer driver and includes the format of each sequence. Definitions of the 
parameters used in the sequence appear after the formats. 

Each sequence ends with an alphabetic character that identifies the 
specific escape sequence. Similar to the screen manipulation escape code 
sequences, the parameters are ASCII-encoded decimal numbers, containing the 
digits 0 through 9. All embedded blanks and control characters are ignored. 
The control code for entering Escape Sequence mode is 01BH. 

Each sequence starts with the Escape Control code 01BH and ends with a 
letter (A through Z and a through z), which allows for only 52 different 
sequences. The left bracket ([) is used to extend the available sequences. 
To parse the escape sequence, the printer driver looks for the escape code, 
another character, and a letter and stores any intermediate characters. The 
character after the escape code, in conjunction with the final character of 
the sequence, define the sequence. Using this method, a specific printer 
driver can ignore any sequence that it does not recognize. 


Sequence Action 

ESC "[" "a or z" Driver/printer reset. 


ESC 

• * £ M 

Ps 

"c" 

Set 

left 

margin. 








Ps = 

number in thousandths 

of 

an 






inch 

increments. 



ESC 

1* £ M 

Ps 

"e" 

Set 

form 

length. 








Ps = 

number in thousandths 

of 

an 






inch 

increments. 



ESC 


Ps 

"d" 

Set 

line 

feed spacing. 








Ps = 

number in thousandths 

of 

an 






inch 

increments. 
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ESC H [ M Pi "o" Set horizontal spacing. 

Pi = number in thousandths of an 
inch increments 

Pi = 0 for proportional spacing. 

ESC [ M Ps *'; H ... M ;. M Ps "h". Set the selected modes. 

ESC "[" Ps M ;" ... '*Ps "l" Clear the selected modes. 

■ Ps selects which mode to enable or 

disable. 

Ps Mode 

0 Select printer. 

1 Auto line feed after carriage 
return. 


ESC "[" Ps 
ESC M [ M Ps 


ESC "[" "b" 


Ps "m" Set attributes. 

Ps "n" Clear attributes. 

Ps selects which attribute to enable 

or disable. 

Ps Attribute 

0 Either sets all attributes 
(except for sub- and 
superscripts) or clears all 
attributes. 

1 Overstrike. 

2 Subscript. 

3 Superscript. 

4 Underscore. 

7 Double underscore. 

Clear platen. 


ESC "[•• Ps "v" Select bin. 

Ps Bin 

1 Bin 1 

2 Bin 2 

3 Envelope bin 

ESC '• ['* Pb H ;" Pc "w" Configure feeder. 

Pb Bin 

1 Bin 1 

2 Bin 2 

3 Envelope bin 


Pc Contents 
0 8.5 * 11 portrait 

1 8.5 * 11 landscape 

2 8.5 * 13 portrait 

3 8.5 * 14 portrait 

4 8.5 * 10.5 portrait 

5 210 mm * 297 mm (A4) portrait 

6 210mm*297 mm (A4) landscape 

7 7.25 * 10.5 portrait 

8 #10 envelope 

9 European envelope 
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ESC "[” Pb "k" 


ESC "[" ”K” 


Transparent data 

Pb = number of bytes 

Transparent data follows the escape 

sequence. 

Reserved 


Accessing the GPP Through DOS Interrupt 21h 

This section describes the GPD functions available through DOS Interrupt 21h. 


Load self ID message (same as when system is booted). 


Function 44h 
Subfunction 03h 
File Handle 04h 


Command string: 
Byte 

Doubleword 


Word 


FFh, send self ID message to user memory. 

Offset and segment of location to send ID 
message 

Length of storage (recommended to be at least 
60 bytes). The storage length will be updated 
with the real length of the message when 
returned, but will not be longer than given. 


The ID message includes a three-byte status block that is updated 
to indicate whether software deselect (Standard mode) or a sheet 
feeder or both are supported by the driver. 


# Start of block 

51 D7 Software deselect 

1 = supported 
0 = not supported 
D6 Sheet feeder 
1 = supported 
0 = not supported 
D5-D0 

Reserved 

52 D7-D0 

Reserved 
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Printer Error Status 

Function 44h 
Subfunction 03h 
File Handle 04h 


Status byte for parallel printers: 

02h Paper out 
04h Fault 

03h Printer deselected 

Status byte for serial printers: 

04h Fault (received printer error code) 
08h Printer deselected 

Command string: 


Byte 


Double word 


Byte 


Function 44h 
Subfunction 02h 
File handle 04h 


FEh, enable printer error status update 
memory. 


in user 


Offset and segment of where to update with printer 
error status. The status update occurs 
approximately every 500ms. This cancels supporting 
printer error status through DOS. ^ 

FDh—disable printer error status update in user 
memory. This enables supporting printer error 
status through DOS (only paper out will cause a 
fatal error). 


Printer error status is read into user memory upon request 
Transparent Mode 

Function 44h 
Subfunction 03h 
File Handle 04h 


Command String: 


Byte FCh Enable Transparent mode. 

Byte FBh Disable Transparent mode and enter Text mode. 


Only do dynamic enabling of Transparent mod< 
current buffered line and checking the Driv< 
ready. 


after terminating the 
Ready/Busy status for 
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The current status of Transparent mode can be read via the Printer Error 
Status call. Subfunction 02h. If the 02h call is made with with a byte 
count of 1/ user memory is only updated with the printer error status* 

If the byte count is 2, the next byte in memory is updated with 
Transparent mode status as follows: 

OOh = Disabled 
Olh = Enabled 

Driver Ready/Busy Status 

Function 44h 
Subfunction 07h 
File Handle 04h 

Check the Ready/Busy status prior to sending any character to the 
driver. Only check the printer error status if the driver is busy. 

Send Byte to Driver 

Function 40h 
File Handle 04h 

This sends up to 64K bytes to the driver. It is recommended to send one 
byte at a time, and check the Read/Busy status first. 


8.4.2 PM011 Printer Driver 


Wang supplies a printer driver specifically for the Wang PM011 printer. Load 
this driver by using the same method used to load the generalized driver. In 
CONFIG.SYS/ include the command 

DEVICE = /DW20DRVR.COM 

The disk from which you install the driver must also contain DAISY06/ from 
which the PM011 driver gets its character table. 

The PM011 printer driver recognizes the following one-byte control codes 


Code Function 

07H Sound the audible tone 

08H Nondestructive backspace 

09H Horizontal tab 

OAH Line feed 

OBH Vertical tab 

OCH Form feed 

ODH Carriage return 

01BH Enter Escape Sequence mode 
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■hxs section describes the standard escape sequences that the PM011 printer 
driver recognizes. The first byte of all escape sequences is 01BH. 

SEQUENCE ACTION 


ESC •■[" Pr 

Pc » H „ 

Position print head at specified row (P r ) 
and column (Pc). Note that the home 
position is Row 0,.. Column 0. (Defaults* Pr 
= 0, Pc = 0) 

ESC "[•• Pr 

; Pc M f" 

Position the print-head exactly like the "H" 
escape sequence. (Defaults: Pr = 0, Pc = 0) 

ESC M [" Pn 

"A" 

Move the print-head up Pn lines. 

(Default: Pn = 1) 

ESC ”[» Pn 

"B" 

Move the print-head down Pn lines. 

(Default Pn = 1) 

ESC "[" Pn 

"C" 

Move the print-head right Pn 
characters. (Default: Pn = 1) 

ESC Pn 

"D" 

Move the print-head left Pn characters 
(Default: Pn = 1) 

He "s" 


Save current print-head position (push). 

ESC " u " 


Restore print-head to previously saved 
position (pop). 

ESC "z" 


Reset printer. 

ESC 


Restore defaults. 

ESC '■[•' »b" 


Clear platen without sheet feed. 

ESC "[" Ps " 

'c n 

Set left margin. 

Ps = number in thousandths of an 
inch increments 

ESC "[" Ps " 

d M 

Set line feed spacing. 

Ps = number in thousandths of an 
inch increments 

ESC "l n Ps " 

e M 

Set form length. 


inch increments 
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ESC "[" Ps i ,# 


ESC Ps M g M 
ESC "[” Ps M v M 
ESC *'[" Pi "o H 


ESC M [ M Ps M ; H 

ESC "[" Ps 

ESC "[" "N” 

ESC "[" Ps M 
ESC "[" Ps 


Issue partial line feed. 

Ps = number in thousandths of an 
inch increments 

Select font or character set number Ps. 
Select paper tray Ps. 

Select pitch. 

Pi = thousandths of an inch per 
character 

Pi = 0 for proportional spacing 

p s "p M Set horizontal tab positions. 

Ps = thousandths of an inch 
increments from left margin 

p s ♦'q 11 Set vertical tab positions. 

Ps = thousandths of an inch 
increments from top of page 

Set Landscape mode. 

Ps "h" Set the selected modes. 
m ; m p s ♦»!*• Clear the selected modes. 

The list of values (Ps) select which 
modes to enable or disable. 

Value Mode 

0 Deselect (l)/select (h) the 

printer. 

1 Auto line feed after carriage 
return. Note: M h" turns on auto 
line feed, "l" turns off auto 
line feed. 

2 Platen direction up (h) down (1) 
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Ps 

Ps 


M 9 <1 
f 


Ps 

Ps 


"ro” 

V 


Set graphics rendition. 
Clear graphics rendition. 


Value 

Action 

0 

All attributes 

1 

Bold 

2 

Subscript 

3 

Superscript 

4 

Underscore 

5 

Emphasize 

6 

Autoslash 

7 

Double underscore 

30 

Set Color 0 

31 

Set Color 1 

32 

Set Color 2 

33 

Set Color 3 

34 

Set Color 4 

35 

Set Color 5 

36 

Set Color 6 

37 

Set Color 7 

50 

Set Color 8 

51 

Set Color 9 

52 

Set Color 10 

53 

Set Color 11 

54 

Set Color 12 

55 

Set Color 13 

56 

Set Color 14 

57 

Set Color 15 


GPD functions)^ driVSr SUPP ° rtS the foUoMin< ? ™T 21h functions 


(a subset of 


Load self ID message (status block not included) 
Printer Error status (subfunction 03h only) 

Driver Ready/Busy status 
Send Byte to Driver 

The PM011 Printer Error Byte returns the following values: 

Hex Meaning 

01 Cover open 

02 Paper out 

04 Ribbon out 

08 Printer deselected 

10 Top-of-form pressed 

20 Feeder empty 

40 Paper jammed in feeder 

80 Printer power off 
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t . 5 DEVICE DRIVERS 


This section provides information on the structure and functions of device 
drivers. The information is intended for for those who want to write their 
own drivers or access an existing driver. Only experienced programmers should 
attesnpt to write or access a driver. 


8.5.1 What Is a Device Driver? 


A device driver is a binary file with all of the code in it to manipulate the 
hardware and provide a consistent interface to MSDOS. In addition, a device 
driver has a special header at the beginning that identifies it as a device, 
defines the strategy and interrupt entry points, and describes various 
attributes of the device. 


NOTE: 

For device drivers, the file must not use the ORG 100H (like .COM files). 
Because it does not use the Program Segment Header, the device driver is 
simply loaded. Therefore, the file must have an origin of zero (ORG 0 or no 
ORG statement). 


There are two kinds of device drivers. 

• Character device drivers 

• Block device drivers. 

Character devices are designed to perform serial character I/O such as 
CON, AUX, and PRN. These devices are named (i.e., CON, AUX, CLOCK, etc.), and 
users may open channels (handles or FCBs) to perform I/O to them. 

Block devices are the "disk drives" on the system. They can perform 
random I/O in pieces called blocks (usually the physical sector size). These 
devices are not named as the character devices are, and therefore cannot be 
opened directly. Instead, they are identified via the drive letters (A:, B:, 
C:, etc.). 


Block devices also have units. A single driver may be responsible for 
one or more disk drives. For example. Block Device Driver ALPHA may be 
responsible for Drives A:,B:,C:, and D:. This means that it has four units 
(0-3) defined and, therefore, takes up four drive letters. The position of 
the driver in the list of all drivers determines which units correspond to 
which driver letters. If Driver ALPHA is the first block driver in the device 
list, and it defines 4 units (0-3), the units will be A:,B:,C: and D: . If 
BETA is the second block driver and defines three units (0-2), the units will 
be E:,F: and G:, and so on. MSDOS 2.0 is not limited to 16 block device 
units, as previous versions were. The theoretical limit is 63 (64-1), but it 
should be noted that after 26, the drive letters are unconventional (such as 
], and "). 
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NOTE: 

Character devices cannot define 
nly one name. 


multiple units because 


character devices have 


8.5.2 Device Headers 


A device header is required at the beginning of a device driver. Figure 8-1 
shows the format of a device header. 


DWORD pointer to next device 
(Must be set to -1.) 


WORD attributes 

Bit 15 = 1 if char device, 0 if blk 
if bit 15 is 1 

Bit 0 = 1 if current sti device 

Bit 1 = 1 if current sto output 

Bit 2 = 1 if current NUL device 

Bit 3 = 1 if current CLOCK dev 

Bit 4 = 1 if special 

Bits 5-12 Reserved; must be set 
to 0. 

Bit 14 is the IOCTL bit. 

Bit 13 is the Non-IBM Format bit. 


WORD pointer to Device Strategy 
entry point 


WORD pointer to Device Interrupt 
entry point 


8-BYTE character device name field 
Character devices set a device name. 
For block devices, the first byte is 
the number of units. 


Figure 8-1. Device Header Format 


Note that the device entry points are words. They must be offsets from 
the same segment number used to point to this table. For example, if XXXiYYY 
points to the start of this table, then XXX:strategy and XXX: interrupt are the 
entry points. 
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Pointer-to-Next-Device Field 

The Pointer-To-The-Next-Device-Header field is a doubleword field (offset 
followed by segment) that is set by MSDOS to point to the next driver in the 
system list at the time the device driver is loaded. It is important that 
this field be set to -1 to load, when it is on the disk as a file, unless 
there is more than one device driver in the file. If there is more than one 
driver in the file, the first word of the doubleword pointer should be the 
offset of the next driver*s Device Header. 


NOTE: 

If there is more than one device driver in the .COM file, the last driver in 
the file must have the pointer to the next Device Header field set to -1. 

Attribute Field 

The Attribute field is used to tell the system whether this device is a block 
or character device (Bit 15). Most other bits are used to give selected 
character devices certain special treatment. (Note that these bits mean 
nothing on a block device). For example, assume that a user has a new device 
driver that the user wants to be the standard input and output. Besides 
installing the driver, the user must tell MSDOS that he wants his new driver 
to override the current standard input and standard output (the CON device). 

To accomplish this, set attribute Bits 0 and 1 (note that they are separate) 
to 1. Similarly, a new CLOCK device could be installed by setting that 
attribute. (Refer to Section 8.5.7, The CLOCK Device, for more information.) 
Although there is a NUL device attribute, the NUL device cannot be 
reassigned. This attribute exists so that MSDOS can determine if the NUL 
device is being used. 

The Non-IBM Format bit applies only to block devices and affects the 
operation of the Build BPB (Bios Parameter Block) device call. (Refer to 
Media Check and Build BPB in Section 8.5.5 for more information on this call.) 

The IOCTL bit has meaning on character and block devices. This bit 
tells MSDOS whether the device can handle control strings (via the IOCTL 
system call. Function 44H). If a driver cannot process control strings, it 
should initially set this bit to 0. This tells MSDOS to return an error if an 
attempt is made (via Function 44H) to send or receive control strings to this 
device. A device which can process control strings should initialize the 
IOCTL bit to 1. For drivers of this type, MSDOS makes calls to the IOCTL 
Input and Output device functions to send and receive IOCTL strings. 

The IOCTL functions allow data to be sent and received by the device for 
its own use (for example, to set baud rate, stop bits, and form length), 
instead of passing data over the device channel as does a normal read or 
write. The interpretation of the passed information is up to the device, but 
it must not be treated as a normal I/O request. 
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Strategy and Interrupt Routine Fields 

The Device Strategy and Device Interrupt fields are the pointers to the entry 
points of the strategy and interrupt routines. They are word values,, so they 
must be in the same segment as the Device Header. 

Name Field 

The Name field is an 8-byte field that contains the name of a character device 
or the number of units of a block device. If it is a block device, the number 
of units can be put in the first byte. This is optional because MSDOS fills 
in this location with the value returned by the driver’s INIT code. Refer to 
Section 8.5.4, Installation of Device Drivers, for more information. 


8.5.3 How To Create a Device Driver 


To create a device driver that MSDOS can install, write a binary file with a 
Device Header at the beginning of this file. Note that for device drivers, 
the code should not be originated at 100H, but rather at 0. The Link field 
(pointer to next Device Header) should be -1, unless there is more than one 
device driver in the file. The Attribute field and entry points must be set 
correctly. 

If it is a character device, fill in the Name field with the name of 
that character device. The name can be any legal 8-character filename. 

MSDOS processes installable device drivers before handling the default 
devices, so to install a new CON device, simply name the device CON. Remember 
to set the standard input device and standard output device bits in the 
attribute word on a new CON device. The scan of the device list stops on the 
first match, so the installable device driver takes precedence. 


NOTE: 

Because MSDOS can install the driver anywhere in memory, care must be taken in 
any far memory references. Your driver is not loaded in the same place every 
time. 
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8.5.4 Installation of Device Drivers 


MSDOS 2.0 allows new device drivers to be installed dynamically at boot time. 
This is accomplished by INIT code in the BIOS, which reads and processes the 
CONFIG.SYS file. 

MSDOS calls upon the device drivers to perform their function by making 
a far call to strategy entry, and then passing (in a Request Header) the 
information describing the functions of the device driver. This structure 
allows you to program an interrupt-driven device driver. For example, you may 
want to perform local buffering in a printer. 


8.5.5 Request Header 


When MSDOS calls a device driver to perform a function, MSDOS passes a Request 
Header in ES:BX to the strategy entry point. This is a fixed length header, 
followed by data pertinent to the operation being performed. Note that it is 
the device driver’s responsibility to preserve the machine state (for example, 
save all registers on entry and restore them on exit). There is enough room 
on the stack when strategy or interrupt is called to do about 20 pushes. If 
more stack is needed, the driver should set up its own stack. 

The Figure 8-2 shows the format of a Request Header. 


BYTE length of record 
Length in bytes of this 
Request Header 


BYTE unit code 
The subunit the operation 
is for (minor device) 

(no meaning on character 
devices) 


BYTE command code 


WORD status 


8 bytes RESERVED 


Figure 8-2. Request Header Format 
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Unit Code 

the Unit Code field identifies the unit in your device driver the request is 
for. For example, if your device driver has 3 units defined, then the 
possible values of the Unit Code field would be 0, 1, and 2. 

Command Code Field 


The Command Code field in the Request Header can have the following values: 


Value Function 


0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 


INIT 

Media Check (Block only, NOP for character) 
Build BPB (Block only, NOP for character) 
IOCTL Input (Only called if device has IOCTL) 
Input (read) 

Nondestructive Read No Wait (Char devs only) 
Input Status (Char devs only) 

Input Flush(Char devs only) 

Output (Write) 

Output (Write) with verify 
Output Status 
Output Flush 

IOCTL Output (Only called if device has IOCTL) 


Media Check and Build BPB 


MEDIA CHECK and BUILD BPB are used with block devices only. 

MSDOS calls MEDIA CHECK first for a drive unit. MSDOS passes its 
current media descriptor byte (refer to Media Descriptor Byte in Section 
8.5.6). MEDIA CHECK returns one of the following results: 

Media Not Changed—Current BPB and media byte are OK. 

Media Changed—Current BPB and media are wrong. MSDOS invalidates 
any buffers for this unit and calls the device driver to build the 
BPB with media byte and buffer. 

Not Sure If there are dirty buffers (buffers with changed data, not 
yet written to disk) for this unit, MSDOS assumes the BPB and media 
byte are OK (media not changed). If nothing is dirty, MSDOS assumes 
the media has changed. It invalidates any buffers for the unit, and 
calls the device driver to build the BPB with media byte and buffer. 

Error If an error occurs, MSDOS sets the error code accordingly. 
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MSDOS will call BUILD BPB under the following conditions: 

If Media Changed is returned. 

If Not Sure is returned, and there are no dirty buffers. 

The Build BPB call also gets a pointer to a one-sector buffer. This 
buffer's contents are determined by the Non-IBM Format bit in the Attribute 
field. If the bit is zero (device is IBM format-compatible), the buffer 
contains the first sector of the first FAT. The FAT ID byte is the first byte 
of this buffer. 


me BPB must be the same, as far as location of the FAT is concerned, for all 
possible media because this first FAT sector must be read before the actual 
BPB is returned. If the Non-IBM Format bit is set, the pointer points to one 
sector of scratch space, which may be used for anything. 


Status Word 

me status word in the Request Header is formatted as follows. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

E B D 

R RESERVED U 0 ERROR CODE (Bit 15 on) 

R S N 

The status word is zero on entry and is set by the driver interrupt 
routine on return. 

Bit 8 is the done bit. When set, the operation is complete. For MSDOS 
2.0, the driver sets the bit to 1 when it exits. 

Bit 15 is the error bit. When set, the low 8 bits indicate the error, 
me errors are 

0 Write protect violation 

1 Unknown unit 

2 Drive not ready 

3 Unknown command 

4 CRC error 

5 Bad drive request structure length 

6 Seek error 

7 Unknown media 

8 Sector not found 

9 Printer out of paper 

A Write fault 

B Read fault 

C General failure 
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Bit 9 is the busy bit, which is set only by status calls. 

) • For output on character devices—If Bit 9 is 1 on return, a write 

request (if made) waits for completion of a current request. If Bit 
9 is 0, there is no current request, and a write request (if made) 
starts immediately. 

• For input on character devices with a buffer—If Bit 9 is 1 on 

return, a read request (if made) goes to the physical device. If 
Bit 9 is 0 on return, characters are in the device buffer and a read 
returns quickly. 0 also indicates that something has been typed. 
MSDOS assumes all character devices have an input type-ahead 
buffer. Devices that do not have a type-ahead buffer always return 
busy=0 so that MSDOS does not continuously wait for something to get 
into a nonexistent buffer. * 


One of the functions defined for each device is INIT. This routine is 
called only once when the device is installed. The INIT routine returns a 
location (DS:DX), which is a pointer to the first free byte of memory after 
the device dnver (simiiar to Keep Process). This pointer method can be used 
to delete initialization code that is only needed once, saving space. 

Block devices are installed the same way and also return a first free 
byte pointer as described above. The following information is also returned: 

• The number of units—This determines logical device names. If the 
current maximum logical device letter is F at the time of the 
install call, and the INIT routine returns 4 as the number of units, 
then the devices have logical names G, H, I and J. This mapping is' 
determined by the position of the driver in the device list, and by 
the number of units on the device, which is stored in the first bvte 
of the Device Name field). 

• A pointer to a BPB (BIOS Parameter Block) pointer array—There is 
one table for each unit defined. These blocks are used to build an 
internal DOS data structure for each of the units. The pointer 
passed to the DOS from the driver points to an array of n word 
pointers to BPBs, where n is the number of units defined. In this 
way, if all units are the same, all of the pointers can point to the 
same BPB, saving space. Note that this array must be protected 
(below the free pointer set by the return) since an internal DOS 
structure is built starting at the byte pointed to by the free 
pointer. The sector size defined must be less than or equal to the 
maximum sector size defined at default BIOS INIT time. If it isn’t 
the install fails. 

• The last thing that INIT of a block device must pass back is the 
media descriptor byte. This byte means nothing to MSDOS, but is 
passed to devices so that they know what parameters MSDOS is 
currently using for a particular drive unit. 
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Block devices may take several approaches; they may be dumb or smart . A 
dumb device defines a unit, and, therefore, an internal DOS structure, for 
each possible media drive combination. For example. Unit 0 = Drive 0 single 
side. Unit 1 = Drive 0 double side. For this approach, media descriptor bytes 
do not mean anything. A smart device allows multiple media per unit. In this 
case, the BPB table returned at INIT must define space large enough to 
accommodate the largest possible media supported. Smart drivers use the media 
descriptor byte to pass information about what media is currently in a unit. 


8.5.6 Function Call Parameters 


All strategy routines are called with ES:BX pointing to the Request Header. 
The interrupt routines get the pointers to the Request Header from the queue 
that the strategy routines store them in. The command code in the Request 
Header tells the driver which function to perform. 


NOTE: 

All DWORD pointers are stored offset first, then segment. 


INIT 


Command Code = 0 
INIT—ES:BX 


13-BYTE Request Header 

BYTE # of units 

DWORD break address 

DWORD pointer to BPB array 
(Not set by character devices) 

The number of units, break address, and BPB pointer are set by the 
driver. On entry, the DWORD that is to be set to the BPB array (on block 
devices) points to the character after the ' = ' on the line in CONFIG.SYS that 
loaded this device. This allows drivers to scan the CONFIG.SYS invocation 
line for arguments. 


NOTE: 

If there are multiple device drivers in a single .COM file, the ending address 
returned by the last INIT called will be the one MSDOS uses. It is 
recommended that all of the device drivers in a single .COM file return the 
same ending address. 
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iedia Check 

nd Code = 1 
MEDIA CHECK—ES:BX 


13-BYTE / Request Header • •• 

BYTE media descriptor from DPB 
BYTE returned 

In addition to setting the status word, the driver must set the return 
byte to one of the following: 

-1 Media has been changed. 

0 Don't know if media has been changed. 

1 Media has not been changed. 

If the driver can return -1 or 1 (by having a door-lock or other interlock 
mechanism), MSDOS performance is enhanced because MSDOS does not need to 
reread the FAT for each directory access. 

Build BPB (BIOS Parameter Block) 



nd Code = 2 
BUILD BPB—ES: BX 


13-BYTE Request Header 


BYTE media descriptor from DPB 


DWORD transfer address 
(Points to one sector worth of 
scratch space or first sector 
of FAT depending on the value 
of the Non-IBM Format bit) 


DWORD pointer to BPB 


If the Non-IBM Format bit of the device is set, the DWORD transfer 
address points to a one-sector buffer, which can be used for any purpose. If 
the Non-IBM Format bit is 0, this buffer contains the first sector of the 
first FAT and the driver must not alter this buffer. 


If IBM-compatible format is used (Non-IBM Format BIT = 0), the first 
sector of the first FAT must be located at the same sector on all possible 
media. This is because the FAT sector is read BEFORE the media is actually 
determined. Use this mode if you only want to read the FAT ID byte. 


Hardware Interface 



8-50 


In addition to setting status word, the driver must set the Pointer to 
the BPB on return. 


The information relating to the 
kept in the boot sector for the media, 
sector is 


BPB for a particular piece of media is 
In particular, the format of the boot 


" 

3 BYTE near JUMP to boot code 



8 BYTES company name and version (WANG #.#) 

B 

WORD bytes per sector 


P 

B 

BYTE sectors per allocation unit 

1 

t 

B 

P 

B 

WORD reserved sectors 

BYTE number of FATs 

WORD number of root dir entries 

WORD number of sectors in logical image 

BYTE media descriptor 

WORD number of FAT sectors 


WORD sectors per track 


WORD number of heads 


WORD number of hidden sectors 



The three words at the end (sectors per track number of heads, and 
number of hidden sectors) are optional. They are intended to help 
understand the media. Sectors per track may be redundant, they cou 

calculated from total size of the disk. Number of heads is useful for 
supporting different multi-head drives that have the same storage capacity, 
but different numbers of surfaces. Number of hidden sectors may e 
support drive-partitioning schemes. 


Media Descriptor Byte 

The last two digits of the FAT ID byte are called the media descriptor byte. 
Currently, the media descriptor byte has been defined for a few me la ypes. 
Refer to Section 5.4.3, Disk Layouts. 

Although these media bytes map directly to FAT ID bytes ‘which are 
constrained to the 8 values F8-FF), media bytes can, m general, be any value 
in the range, 0-FF. 
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or WRITE 


►mmand Codes = 3, 4, 8, 9, and 12 

READ or WRITE—ES:BX (Including IOCTL) 
13-BYTE Request Header 
BYTE media descriptor from DPB 
DWORD transfer address 


WORD byte/sector count 

WORD starting sector number 
(Ignored on character devices) 

In addition to setting the status word, the driver must set the sector 
count to the actual number of sectors (or bytes) transferred. No error check 
is performed on an IOCTL I/O call. The driver must correctly set the return 
—_ sec&or^Jbyte) count to the actual number of bytes transferred. 

NONDESTRUCTIVE READ NO WAIT 


Command Code = 5 


NONDESTRUCTIVE READ NO WAIT—ES:BX 
13-BYTE Request Header 
~~ "-- - BYTE read from device 

If the character device returns busy bit = 0 (characters in buffer), the 
next character that would be read is returned. This character is not removed 
from the input buffer (hence the term "Nondestructive Read"). Basically, this 
call allows MSDOS to look ahead one input character. 
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STATUS 


Command Codes = 6 and 10 
STATUS Calls—ES:BX 

13-BYTE Request Header 

The driver must set the status word and the busy bit as follows: 

For output on character devices—If Bit 9 is 1 on return, a write 
request (if made) waits for completion of a current request. If it 
is 0, there is no current request and a write request (if made) 
starts immediately. 

For input on character devices with a buffer—A return of 1 means a 
read request (if made) goes to the physical device. If it is 0 on 
return, characters are in the device's buffer and a read returns 
quickly. A return of 0 also indicates that the user has typed 
something. MSDOS assumes that all character devices have an input 
type-ahead buffer. Devices that do not have a type-ahead buffer 
should always return busy = 0 so that the DOS will not hang waiting 
for something to get into a nonexistent buffer. 


FLUSH 


Command Codes = 7 and 11 
FLUSH Calls—ES:BX 

13-BYTE Request Header 

The FLUSH call tells the driver to flush (terminate) all pending 
requests. Use this call to flush the input queue on character devices. 


8.5.7 The Clock Device 


Th CLOCK device is a special device determined by the attribute word. The 
CLOCK device defines and performs functions like any other character device. 
Most functions will be: set done bit, reset error bit, return. When a read 
or write to this device occurs, exactly six bytes are transferred. The first 
two bytes are a word that is the count of days since 1-1-80. The third byte 
is minutes; the fourth, hours; the fifth, hundredths of seconds; and the 
sixth, seconds. Reading the CLOCK device gets the date and time; writing to 
it sets the date and time. 
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APPENDIX A 
MESSAGES 


A.1 INTRODUCTION 


This appendix lists the error messages returned by the Linker, the Library 
Manager, and the Debugger. The list describes the cause of the error and, 
where appropriate, the way to correct it. 


A.2 LINKER MESSAGES 


All errors cause the Linker session to abort. Therefore, after you find and 
correct the cause, you must run the Linker again. 



During the Linker session, you can receive any of 
essages: 


ATTEMPT TO ACCESS DATA OUTSIDE OF SEGMENT BOUNDS, 
MODULE 


the following error 


POSSIBLY BAD OBJECT 


Probably a bad object file. 

BAD NUMERIC PARAMETER 

Numeric value not in digits. Use characters from 0 through 9 only. 
CANNOT OPEN TEMPORARY FILE 

The Linker is unable to create the file VM.TMP because the disk is 
full. Insert a new disk. Do not change the disk that receives the 
list.MAP file. 


Messages 



ERROR: DUP RECORD TOO COMPLEX 

A DUP construct in an Assembler language module is too complex. 
Simplify the DUP construct in the Assembler language program. 

ERROR: FIXUP OFFSET EXCEEDS FIELD WIDTH 

An Assembler language instruction uses a short address (an offset 
only) for something the Linker has positioned more than 64KB away from 
the base. Edit Assembler language source and reassemble. 

INPUT FILE READ ERROR 

Probably a bad object file. 

INVALID OBJECT MODULE 

Object module(s) incorrectly formed or incomplete (as when assembly 
was stopped in the middle). 

PROGRAM SIZE OR NUMBER OF SEGMENTS EXCEEDS CAPACITY OF LINKER 

The total size cannot exceed 384KB, and the number of segments cannot 
exceed 255. 

REQUESTED STACK SIZE EXCEEDS 64KB 

Specify a size less than or equal to 64KB with the /STACK switch. 
SEGMENT SIZE EXCEEDS 64K 

The addressing system limit is 64KB. 

SYMBOL DEFINED MORE THAN ONCE 

The Linker found two or more modules that define a single symbol name. 
SYMBOL TABLE CAPACITY EXCEEDED 

Many, very long names entered, the total list exceeding approximately 
25KB. 


Messages 


TOO MANY EXTERNAL SYMBOLS IN ONE MODULE 

The limit is 256 external symbols for each module. 

TOO MANY GROUPS 

The limit is 10 groups. 

TOO MANY LIBRARIES SPECIFIED 
The limit is 8 libraries. 

TOO MANY PUBLIC SYMBOLS 

The limit is 1024 public symbols. 

TOO MANY SEGMENTS OR CLASSES 

The limit is 256 segments and classes taken together. 

UNRESOLVED EXTERNALS: <list> 

The external symbols listed have no defining module among the 
modules or library files specified. 

VM READ ERROR 

File VM.TMP cannot be read. A disk problem; not caused by the 
Linker. 

WARNING: NO STACK SEGMENT 

A bad object module or an attempt to link a module that the Linker 
cannot handle because it is nonrelocatable, for example, a module 
already linked. 

WRITE ERROR IN IMP FILE 

No more disk space remaining to expand the VM.TMP file. 

WRITE ERROR ON RUN FILE 

Usually, not enough disk space for the run file. 


Messages 



.3 LIBRARY MANAGER MESSAGES 


During the Library Manager session, you can receive any of the following 
rror messages: 

<symbol> is a multiply defined PUBLIC. Proceed? 

A new module defines the same public symbol as a module already in 
the library. The message asks you to confirm the removal of the old 
definition of the symbol. A No response leaves the library in an 
undetermined state. Remove the PUBLIC declaration from one of the 
object modules and recompile or reassemble. 

Allocate error on VM.TMP 

No more space on the disk when the file is being opened. 

Cannot create extract file 

No place in the disk directory for the file to be created by copying 
a module from the library file (the Asterisk command). 

Cannot create list file 

No place in the disk directory for the list file. 

Cannot nest response file 

A response file cannot contain a response file (<@filespec>) as a 
parameter. 

Cannot open VM.TMP 

No place for VM.TMP in the disk directory. 

Cannot write library file 

No more space on the disk. 

Close error on extract file 

Not enough space on the disk for the file created by copying a 
module from the library file (the Asterisk command). 


Messages 



Error: An internal error has occurred 

Contact the Wang Professional Computer Assistance Center. Refer to 
The Wang Professional Computer Introductory Guide for the toll free 
number. 

Fatal Error: Cannot open input file 

The object file name is improperly formed, or it cannot be found in 
the disk directory. 

Fatal Error: Module is not in the library 

You are trying to delete a module that is not in the library. 

Input file read error 

A bad object module or faulty disk. 

Invalid object module/library 

A bad object module and/or library. 

Library Disk is full 

No more space on the disk. 

Listing file write error 

No more space on the disk. 

No library file specified 

No response to Library File prompt. 

Read error on VM.TMP 

Disk not ready for read. The disk drive door is open or the disk is 
not properly placed in the drive. 

Symbol table capacity exceeded 

Too many characters (about 30KB) in public symbols. 

Too many object modules 

More than the maximum of 500 object modules. 

Too many public symbols 

More than the maximum of 1024 public symbols. 


Messages 



Write error on library/extract file. 

Not enough space on the disk for a library 
from a library. 

Write error on VM.TMP 

No more space on the disk. 


file or a file extractei 



A.4 DEBUGGER MESSAGES 


During the DEBUG session, you can receive any of the following error codes. 
Each error terminates the DEBUG command with which it is associated, but does 
not terminate DEBUG itself. 

ERROR CODE DEFINITION 

BF Bad Flag 

On an attempt to alter a flag, the characters you entered 
were not one of the acceptable pairs of flag values. Refer 
to Section 4.6, the R Command, for the list of acceptable 
flag entries. 

BP Too many Breakpoints 

More than 10 breakpoints specified as parameters to the 
Command. Reenter the G Command with 10 or fewer 
breakpoints. 

BR Bad Register 

An R Command entered with an invalid register name. Refer 
to Section 4.6, the R command, for the list of valid 
register names. 

DF Double Flag 

Two values entered for one flag. You can specify a flag 
value only once for each RF Command. 



Messages 
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IBM PERSONAL COMPUTER TO WANG 


PROFESSIONAL COMPUTER CODE CONVERSION 


B.l INTRODUCTION 


You can convert programs in BASIC from the IBM 
Professional Computer. The following sections 
conversion. 


Personal Computer to the Wang 
give guidelines for the 


B *2 KEYBOARD. PRINTER. AND SCREEN PROTOCOLS 




the S wTna X K OCii ?h Ca M i0nS l^ ced to run Programs written in IBM BASIC on 
the Wang PC. The Microsoft BASIC language interpreter is functional,, 
co.gtibl. with th. IBM PC Advanced b£i? lang^e 

konv!rt d ° ! X1St in thC keyboard and display protocols. When you are 
konvertmg existing programs or developing new programs, it is qood stratum 
)> use variables to represent key and display valSs in the cSde 97 

/° r example, suppose the program is to display a vertical bar on each of 
tbm' S ® machin ® s; ln the Program, you could define a variable VERTBARS On the 
!BM PC you let VERTBAR$ equal CHR$(179). However, on the Wang rc^e^t 

*“ *■«- 

is to h test e l£fth! C8n alS ° b ! applied t0 the keyboard. Suppose the program 
h V°!! f °^ * he P ressin 9 of the PF01 key (when disabled as a soft key) In 

S^Ss^ buff^V r ria ^ e PF ° 1KE Y $ - 011 the IBM rc ' se t PF01KEY$ equal to 
HR$(059), but on the Wang PC it would equal a CHR$(128) Then the variahio 

SSSg'niSl ValU ! f r, the INKEY$ Jtat-J^Ji-oSSdto the riable 
particular to one'm!chi!!. ° C ° mparin9 lfc to a ^rd-coded keystroke value 


for L!^!i hiS tec ^? ue a ste P further, a standard header could be built 

gi ve^machine 1 ^This'st°V he key and display va ^ that exist on a 
d v W Ml standard header could then be merged into each program 
developed to improve the readability and transportability of your software. 
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B.2.1 Keyboard Values 

Key values on the IBM PC are equal to those on the Wang PC. This compar; 
is limited to the keys available on both machines as there are some keys 
available on the Wang PC keyboard that are not available on the IBM PC 
keyboard, and vice versa. Refer to the discussion of the keyboard in The Wang 
Professional Computer Introductory Guide . 

For certain keys or key combinations that cannot be stored as a standard 
WISCII code, the BASIC INKEY$ statement returns an 2-byte code. The value 
CHR$(128) is returned to indicate that an extended code follows. If the first 
character received is a CHR$<128), then a second code is pending in the 
keystroke buffer. Execution of another INKEY$ statement returns this second 
code immediately. The following list gives the WISCII codes for this second 
character (in decimal) and the keys that return them. Where the key has a 
defined function, the function is given. The list is valid for Versions 1.04 
and above of Wang PC BASIC. 


Key 


Second Code 

Shift/Cancel 


3 

PF01 to PF12 


32 - 43 

PF13 


Dead key 

PF14 


20 

PF15 


12 (Clears screen) 

PF16 


1 

PF17 to PF32 


48 - 63 

Cursor Up 


30 

Cursor Right 


28 

Cursor Down 


31 

Cursor Left 


29 

Home 


11 

Execute 


13 

Return 


13 

Insert 


18 

Delete 


127 

Prev 


2 

Next 


6 

Erase 


5 

Backtab 


2 

Shift/Cursor 

Up 

30 

Shift/Cursor 

Right 

6 

Shift/Cursor 

Down 

31 

Shift/Cursor 

Left 

2 

Shift/Home 


11 

Shift/Execute 

13 

Shift/Insert 


14 

Shift/Delete 


23 

Shift/Prev 


2 

Shift/Next 


6 

Shift/Erase 


26 

Shift/Tab 


4 

Shift/Backtab 

2 
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Key 

Cancel 

Help 

GL (glossary) 

Print 

Shift/Help 
Shift/GL (glossary) 
Shift/Print 


Second Code 

No code returned 
144 

Dead key 
47 

Terminates program 
Dead key 

Hot-prints screen 


B•3 TRANSPORTING TEXT FILES FROM THE IBM PC TO THE WANG PC 


Media compatibility exists between the Wang PC and the IBM PC. The Wang PC 
can read SSDD or DSDD 5.25-inch diskettes formatted on the IBM PC. Because 
both systems use virtually the same operating system, the diskette formats are 
fully compatible. Therefore, the Wang PC can read all source programs and 
data files created by the IBM PC-DOS, without any difficulty. Save BASIC 
source programs that are to be transported in ASCII format. The Wang PC BASIC 
Compiler cannot read source files in condensed format. 

Another method of transporting source programs and data files between the 
two machines is available if both systems are equipped with asynchronous 
communications hardware and software. Both Wang and IBM offer optional 

P ynchronous communications software. However, the hardware is an option on 
r IBM PC* 0n the Wang PC, the RS-232-C communications port is standard. 

To transfer text files from the IBM PC to the Wang PC, use the IBM 
Asynchronous Communications Support software and the Wang Professional 
Computer Asynchronous Communications software. The following are some 
constraints imposed by the protocol used in the IBM Asynchronous 
Communications Support software: 

• Files must be textual and cannot contain more than 254 characters per 
line. 

• BASIC source programs must be in ASCII format. 

• Each line in the file must end with CR/LF. 

• Each file must terminate with a CONTROL + Z. 

• A full duplex protocol is employed [using XON (CONTROL + Q) and XOFF 
(CONTROL + S)] to prevent communication buffer overflow during data 
reception. 
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The following sample BASIC program illustrates how you can transport text 
files from the IBM PC to the Wang PC using asynchronous communications. The 
program assumes a 300 bits per second (bps) line, even parity, seven data 
bits, and an input buffer of 256 bytes. Characters received are echoed on th 
video monitor to verify receipt of valid characters. 

10 CLS:WIDTH 80: KEY OFF: DEFINT A-Z 

20 LOCATE 10,10: INPUT "(T)transmit or (R)receive XMIT$ 

30 LOCATE 12,10: INPUT "ASCII Filename NAM$ 

40 IF XMITS = "t" OR XMIT$ = "T" GOTO 150 

50 REM LINES 60-130 RECEIVE FILE FROM COM PORT 

60 OPEN NAM$ FOR OUTPUT AS #1 

70 OPEN "coml:300,E,7,l" AS #2 

80 IF LOC(2)=0 THEN GOTO 80 

90 WHILE NOT EOF<2) 

100 LINE INPUT #2,A$ 

110 PRINT #1, A$ 

120 WEND 

130 CLOSE: GOTO 220 

140 REM LINES 150-210 TRANSMIT FILE TO COM PORT 
150 OPEN NAM$ FOR INPUT AS #1 
160 OPEN "coml:300,E,7,l" AS #2 
170 WHILE NOT EOF(l) 

180 LINE INPUT #1, A$ 

190 PRINT #2, A$ 

200 WEND 
210 CLOSE 

220 LOCATE 20,30: PRINT "Transfer Complete" 

230 END 
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ABBREVIATIONS GLOSSARY 


A bbreviation Meaning 


AF 

ANSI 

ASCII 

ASCIZ 



oxS, 

p ot*\ s 7 W (2. 


Auxiliary Carry Flag, r-2 
American National Standards Institute 
American Standard Code for Information Interchange 
ASCII string with a hex zero used as an end-of-string 
indicator 
Auxiliary Device 
Basic I/O System, 5“-0 
BIOS Parameter Block 


A/Ai<-0e</ / s~-io 

JT-'O ' 

BPS /9<»r f t'+xrjr, J-fO 

BPS BiT'-r f>er Second 

cpi per 

C ^ Jl cL Sirred A C 


Carry Flag, 5-3 
Character 
Console Device 
Cyclic Redundancy Check,? r/ 

Code Segment (register) 4-3 Clt^rTo SencL,y-xi 

Decimal DCD C/mnrir T)t>\«*A 

Direction Flag, T- 4 - DTA, Dijfc T**a{ 4tr S~-(b 

Direct Memory Access,?- 


PA K-T ( 7-/f 

>/ 4 


Disk Operating System*5-1 
Device Parameter Block 
Data Segment (register), 4*7 
Disk Transfer Address 
Double Word 

Extra Segment (register) 

Escape 

File Allocation Table 
File Control Block, r-iU 
Hexadecimal 
Hexadecimal 
Interrupt Flag, x -4 
Software Interrupt 
I/O Control (DOS function call) 

Instruction Pointer (register); 4"3, 5-1, 

Return from Interrupt (Assembler instruction) 

Light-Emitting Diode lFX Llwej pefL , M c« 

Overfiow Fla g ( 5 -^ U 0 L,br^,3-| 

Parity Flag,X~4* J 1 

Printer Device 

Programmable Read-only Memory 

Program Segment Header, 4 - 3 , 5 - 10 , 5-15, 4 - i<. 

Queue Identification Number 7 * 7 -\ 




tCC fcvror (JaccUi'aq *■ 

Qxec^i* Ue f 

FRC 

£>PZ |8 1 -u 

ruire- 48^, 

XVG (Hack, ?*/4- 


/X L 


; w r 


r 


Glossary 


Abbreviation 


Meaning 


-2 


Sign Flag,5-4- SpeciA L 1-4- 

Stack Pointer (register), 4-3. 5-n 
Stack Segment (register),4-4 
Standard Input Device 
Standard Ouptut Device 
Trap Flag, 5-V 

Wang International Standard Code for Information 
Interchange 
Zero Flag r-4- 

[<C-Tf fce-W* 4“ la 

^w\TcHCATij Sr-U? 

R c 13 ( OUrk. 

Sb/A Device } 7-10 

V 0\$K 

p iyc 7- 17L 

RKG -7-12- 
v: 7-1-7- 


SF 

SP 

SS 

STI 

STO 

IF 

WISCII 

ZF 
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A (Assemble) command, 4-9 to 4-11 
Abbreviations glossary, C-l, C-2 
Absolute disk read interrupt, 

6-5 

Absolute disk write interrupt, 

6-5 

Addressing, 5-5^0 5-7 
Address parameter, 4-6 
Allocate DMA channel BIOS 
function, 7-2 

Allocate memory function call, 
6-43 

Ampersand (&) command character, 
3-7 

Architecture overview, 5-1 to 

5-7 

flags, 5-3 to 5-6 
memory, 5-2, 5-5 to 5-7 
registers, 5-1 to 5-3 

F IZ character string, 6-7 

erisk (*) command character, 
3-6 

Asynchronous communications, 7-21 
to 7-24 

Auxiliary input function call, 

6-14 

Auxiliary output function call, 
6-14 

AVAILDEV command, 5-10 7 

BACKSPACE command, 1-5 
.BAK backup files, 1-3 
BIOS, 7-1 to 7-24 

asynchronous communications, 

7-21 to 7-24 

disk drive control blocks, 

7-9, 7-10 

disk I/O requests, 7-15 to 7-20 
IEEE-488 (GPIB) interface 
option board, 7-11 
Interrupt vector usage, 7-21 
Local communications card, 7-12 
return codes, 7-3 
13I0IIAJIT, JT-i* 


screen information block, 7-6 
to 7-9 

shared device memory, 7-10 to 
7-14 

software interface, 7-1 to 7-3 
system configuration table, 7-6 
three-port MCC board, 7-13, 

7-14 


trappable events, 7-4, 7-5 
BIOS functions, 7-1, 7-3 
Allocate DMA channel, 7-2 
Console input buffer handler, 
7-3 

Clear event trap, 7-1 
Enqueue disk 1/0 request, 7-2 
Free DMA channel, 7-2 
Keyboard query for BL status, 
7-3 

Send block of characters to 
screen, 7-3 

Send bytes to keyboard, 7-2 
Send character to screen, 7-2 
Set DMA channel, 7-2 
Set event trap, 7-1 
Set pointer to configuration 
table, 7-1 

Set pointer to system name, 
7-1 


Warm boot, 7-3 
BREAK command, 5-10 
Buffered keyboard input function 
call, 6-15 

BUFFERS command, 5-10 
Build BPB driver function, 8-46, 

8-49, 8-50 


Byte parameter, 4-6 

5 - 1 , >3 
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C (Compare) command, 4-12 
Center mode, 1-3, 1-6 
CENTER MODE command, 1-6 
Change attributes function call, 
6-38, 6-39 

Change current directory function 
call, 6-35 
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Change incompatible configuration 
parameters function call, 

6- 32 

Check keyboard status function 
call, 6-16 ckecK 

Class, 2-3 to 2-6 
Clear event trap BIOS function, 

7- 1 

Clear portions of line escape 
sequence, 8-8 

Clear portions of screen escape 
sequence, 8-8 

Close a file function call (2.0), 
6-36 

Close file function call 
(pre-2.0), 6-18 

Code conversion, IBM PC to Wang 
PC, B-l to B-4 
.COM files, 5-16' 5-17' 

Command characters 
library manager 
Linker, 2-11 

COMMAND.COM, 5-8' 5-13' to 5-19 
switches, 5-11' 

CONFIG.EDT, 1-2, 1-3 
CONFIG.SYS, 5-8' 5-10' 5-ll' 
Console input buffer BIOS 
function, 7-3 
Control codes 

generalized printer drivers, 

8- 32 

PM011 driver, 8-36 
screen, 8-1 

CONTROL + characters, 8-18 
COPY command, 1-6 
CP/M Calling conventions, 6-24 
Create a file function call 
(2.0), 6-35 

Create file function call 
(pre-2.0), 6-21 

Create a subdirectory function 
call, 6-34 

Current disk function call, 6-21 
CURSOR movement commands, 1-4 
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D (Dump^j command, 4-13 
Dead keys, 8-11, 8-19 x , 
Debugger, 4-1 to 4-41 
initialization, 4-3, 


, 4-14 
8-20 


4-4 


invoking, 4-1, 4-3 
messages, A-6 
using, 4-4, 4-5 
Debugger commands, 4-4 to 4-5 
A (Assemble), 4-9 to 4-11 
C (Compare), 4-12 
D (Dump), 4-13, 4-14 
E (Enter), 4-15, 4-16 
F (Fill), 4-17 
G (Go), 4-18, 4-19 
H (Hexarithmetic), 4-20 
I (Input), 4-21 
L (Load), 4-22, 4-23 
M (Move), 4-24, 

N (Name), 4-25 to 4-27 
0 (Output), 4-28 
P (Proceed), 4-29, 4-30 
Q (Quit), 4-31 
R (Register), 4-32 to 4-34 
S (Search), 4-35 
T (Trace), 4-36, 4-37 
U (Unassemble), 4-38, 4-39 
W (Write), 4-40, 4-41 
Debugger Parameters, 4-5, 4-8 
<address>, 4-6 
<byte>, 4-6 
<device>, 4-6 


<drive>, 4-6 
<filespec>, 4-6 
<list>, 4-6 
<range>, 4-7 

<register-name>, 4-7, 4-32 
<sector>, 4-7 
<string>, 4-7 
<value>, 4-8 

Delete a directory entry function 
call, 6-37, 6-38 
DELETE character command, 1-5 
Delete characters from line 
escape sequence, 8-9 
Delete file function call, 6-19 
DELETE line command, 1-5 
Delete lines escape sequence, 8-9 
DEVICE command, 5-10 
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^Device drivers, 8-40^to 8-52 
■ clock device, 8-52 
^ device headers, 8-41 to 8-43 
function call parameters, 8-48 
to 8-52 

how to create, 8-43 
installation of, 8-44 
request header, 8-44 to 8-48 
what is a device driver, 8-40, 

8-41 

Device driver functions, 8-48 to 
8-52 

Build BPB, 8-49, 8-50 
Flush calls, 8-52 
Init, 8-48 
Media check, 8-49 
Nondestructive read no wait, 

8-51 

Read or Write, 8-51 
Status, 8-52 
Device parameter, 4-6 
Direct console input function 
call, 6-15 

Direct console I/O function 
call, 6-14 

Bisk directory, 5-28, 5-29 
Bisk Drive Control Blocks, 

F 7-10 

Disk error handling, 5—19^ 

Disk I/O requests (BIOS), 

7-20 

Disk reset function call, 6-17 
Disk space allocation, 5-28 
Disk Transfer Address (DTA), 5-22'SHfr - U* 
Diskette layouts, 5-22 / to 5-24 J 


7-9, 

Disk 

7-15 to 


Display character function call, 
6-13 

Display characters in image mode 
escape sequence, 8-10 

DOS 

Command Processor, 5-13 to 5-19 
disk error handling, 5-19 
initialization, 5-8 to 5-12 
memory usage, 5-13, 5-15 
program initialization, 

5-15 to 5-18 

technical information, 5-8 to 
5-19 
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Drive designation parameter, 2-6 
Drive parameter, 4-6 
DSALLOCATE switch, 2-12 
Duplicate a file handle function 
call, 6-42 



E (Enter) command, 4-15, 4-16 

Editing modes, 1-3, 1-6 

Editor, 1-1 to 1-7 

.BAK backup files, 1-3 
buffer size, 1-3 
commands, 1-3 to 1-7 
configuration parameters, 1-2 
exiting from, 1-2 
help screens, 1-2 
invoking, 1-1, 1-2 
line numbers, 1-3 
window, 1-3 

Editor commands, 1-4 to 1-7 
BACKSPACE, 1-5 
CENTER, 1-6 
CONTROL + C, 1-2 
COPY, 1-6 
CURSOR EAST, 1-4 
CURSOR NORTH, 1-4 
CURSOR SOUTH, 1-4 
CURSOR WEST, 1-4 
DEC TAB, 1-4 
DELETE, 1-5 
ERASE, 1-5 
EXEC, 1-5 
FORMAT, 1-6 
GO TO, 1-4 
INDENT, 1-7 
INSERT, 1-5 
MOVE, 1-6 
NEXT, 1-4 
PAGE, 1-6 
PREV, 1-4 
PRINT, 1-6 
REPLC, 1-5 
SEARCH, 1-6 
T, 1-6 
TAB, 1-6 

SHIFT + CANCEL, 1-2 

SHIFT + CURSOR commands, 1-3 

SHIFT + DELETE, 1-5 

SHIFT + ERASE, 1-5 

SHIFT + GO TO, 1-7 
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SHIFT + INDENT, 1-7 
SHIFT + NEXT, 1-4 
SHIFT + PREV, 1-4 
SHIFT + SEARCH, 1-6 
STOP, 1-5 
TAB, 1-12 

Enqueue disk I/O request BIOS 
function, 7-2 
ERASE command, 1-5 
Erase window escape sequence, 

8-10 

Error messages, see messages 
Escape sequences, printers 
generalized printer drivers, 

8-29, 8-30, 8-32 to 8-34 
PM011 printer, 8-37 to 8-39^ 

Escape sequences, screen, 8-1 to 
8 - 10 } 7-3 

.EXE files, 5-17^ 5-18”" 

EXEC command, 1-5 f ■ /•'' r j 

Extended file control block, w r , ** * 
5-19, 5-21, 5-22 
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F (Fill) command, 4-17 
FAT ID byte, 5-23 to 5-24 
Fatal error abort vector 
interrupt, 6-3, 6-4 
File Allocation Table (FAT), 5-30 
File Control Block, 5-19 to 5-22 
File handle, 6-7 
File management, 5-19 to 5-30 
File size function call, 6-23 
Filename parameter, 2-6 
Extension parameter, 2-6 
Filespec parameter, 2-6 
FILES command, 5-10 
Find first file match function 
call, 6-41 

Find next file match function 
call, 6-48 
Flag codes, 4-33 
Flags 

8086, 5-3' 5-5 
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Debugger, 4-33 

Floating cursor mode, 1-3, 1-6 
Flush buffer, read keyboard 
function call, 6-16 
Flush calls driver function, 8-52 


Force a duplicate of a handle 
function call, 6-42 
FORMAT command, 1-6 
Free allocated memory function 
call, 6-44 

Free DMA channel BIOS function, 

7- 2 

Function calls, 6-6 / to 6-49 
2.0 function calls, 6-29 to 
6-49 

pre-2.0 function calls, 6-13 to 
6-28 

Xenix compatible function 
calls, 6-34 to 6-49 
Function request interrupt, 6-2 

G - -- 

G (Go) command, 4-18, 4-19 
Generalized printer drivers, 8-22 
to 8-36 

character translate table, 

8- 30, 8-31 

escape sequences, 8-28 to 8-30 
8-32 to 8-34 
index table, 8-24 
interrupt 21H functions, 8-34^| 
to 8-36 ^ 

loading, 8-23 to 8-25 
power-on defaults, 8—23, 8—26 
printer function table, 8-25 to 
8-30 

Get date function call, 6-27 
Get disk free space function 
call, 6-31 

Get Disk Transfer Address 
function call, 6-29 
Get DOS version number function 
call, 6-29 

Get interrupt vector function 
call, 6-31 

Get/set date/time of file 
function call, 6-49 
Get time function call, 6-28 
GO TO command, 1-4 
group, 2-3 to 2-6 
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H (Hexarithmetic) command, 4-20 
Help screens, 1-2 
HIGH switch, 2-12 


I (Input) command, 4-21 
IBM PC to Wang PC code 

conversion, B-l to B-4 
keyboard, printer, and 

screen protocols, B-l to 
B-3 

keystroke values, B-2, B-3 
transporting text files, B-3, 
B-4_. 

IEEE-488 (GPIB) interface option 
board, 7-11 
INDENT command, 1-7 
INIT driver function, 8-48 
INSERT, 1-5 

Insert Lines escape sequence, 8-9 
Instruction Pointer 
Interrupt vector usage (BIOS), 
7-21 

Interrupt vectors, 5-14, 5-15 
Interrupts (DOS), 6-1 to 6-5 
Absolute disk read, 6-5 
Absolute disk write, 6-5 
Fatal error abort vector, 6-3, 
6-4 

Function request, 6-2 
Program terminate, 6-2 
SHIFT + CANCEL exit address, 

6-3 

Terminate address, 6-2 
Terminate but stay resident, 

6-5 

Invisible dead keys, 8-20' 

I/O control for devices function 
call, 6-39 to 6-42 
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K 

Keep process function call, 6-30 
Keyboard query for BL status BIOS 
function, 7-3 


k__ 

L (Load) command, 4-22, 4-23 
LEDs (Light-Emitting Diodes), 

8-7 

Libraries prompt, 2-10 
Library file prompt, 3-9 
Library Manager, 3-1 to 3-9 
command characters^ 3-6 to 3-7 
command prompts, 3-8, 3-9 
features, 3-1 
messages, A-4 to A-6 
operation, 3-2 to 3-4 
running, 3-5 to 3-8 
system requirements, 3-4 
Line numbers, 1-3 
LINENUMBERS switch, 2-12 
Linker, 2-1 to 2-13 
combine types, 2-4 
command characters 2-11 
command prompts 2-10 
files, 2-6, 2-7 
messages, A-l to A-3 
operation, 2-1, 2-2, 2-3 to 2-6 
running, 2-7, 2-9 
switches, 2-12 to 2-13 
system requirements, 2-2 
Linker switches, 2-12 to 2-13 
-DSALLOCATE, 2-12 
-HIGH, 2-12 
-LINENUMBERS, 2-12 
-MAP, 2-13 
-PAUSE 2-13 
-STACK, 2-13 

List file Library Manager prompt, 
3-9 

List file Linker prompt, 2-10 

list parameter, 4-6 

Load and Execute a program 

function call, 6-45, 6-46 
Local communications card, 7-12' 
Logical keyboard protocol, 8-11 
to 8-21 

control characters, 8-18 
dead keys, 8-19, 8-20 
physical keyboard, 8-20, 8-21 
sample keyboard description, 

8-21 


■ ■■ . -.Vi* o i £‘-li 

IdOAvA lou'f'ffvr 7-1 f ^/ys ^ 1 

PROK 7-3 

vJ * 


Index-5 


INDEX (continued) 


BooT 1-2. 
p(t0M - %0A (&> t 1 -3 


simple characters, 8-11 to 8-18 
special characters, 8-19 
WISCII I character set, 8-11 to 
8-17 



P (Proceed) command, 4-29, 4-30 
Palette entries, 8-5, 8-6 
Palette entry attributes, 8-5, 


VL 


- S'-”2. 

Pars^ file name function call. 


M (Move) command, 4-24 

MAP switch, 2-13 

MCC board, 7-13, 7-14 3-2/2. 

Media check driver function, 

8-45, 8-49 

Memory usage, 5-13 to 5-15 j S-S 
MENUDRVR.COM, 5-8, 5-10 to 5-15 
Messages 

Debugger, A-6 
Library Manager, A-5, A-6 
Linker, A-l to A-4 
Minus sign (-) command character, 
3-6 

Modify allocated memory block 
function call, 6-44 
Module, 3-1 

Move a directory entry function 
call, 6-48 

Move a file pointer function 
call, 6-38 

Move a window escape sequence, 
8-10 

MOVE command, 1-6 

Move Cursor escape sequence, 8-8 

N 

N (Name) command, 4-25 to 4-27 
NEXT command, 1-4 
Nondestructive read no wait 
driver function, 8-51 


6-26, 6-27 
PAUSE switch, 2-13 
Plus sign (+) command character, 
3-6 

PM011 printer driver, 8-36 to 
8-39 

control codes, 8-36 
error codes, 8-39 
escape sequences, 8- 37 t o B-3£ 
interrupt 21H functions, 8-39 
Position cursor escape sequence, 
8-8 

Pre-2.0 function calls, 6-13 to 
6-28 


PREV command, 1-4 
Print character function call, 
6-14 

PRINT command, 1-6 
Printers drivers, 8-22 to 8-39 
generalized printer drivers, 
8-22 to 8-36 

PM011 printer driver, 8-36 to 


8-39 

Produce output with attributes 
escape sequence, 8-3, 8-4 
Program initialization, 5-15 to 
5-18 

Program terminate interrupt, 6-2 
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Q (Quit) command, 4-31 


0 (Output) command, 4-28 
Object file, 3-1 
Object module, 3-1 
Object modules prompt, 2-10 
Open file function call (pre- 
2.0), 6-17, 6-18 
Open file function call (2.0), 
6-36 

Operation prompt, 3-9 
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R (Register) command, 

4-32 to 4-34 

Random block read function call, 
6-24, 6-25 

Random block write function call 
6-25 

Random read function call, 6-22 
Random write function call, 6- 
Range parameter, 4-7 
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Read a file or device function 
^ call , 6-36, 6-37 
Head keyboard function call, 6-15 
Hegister-name parameter, 4-7 
Registers, 5-1 to 5-3 
Remove directory entry function 
call, 6-34 

Rename file function call 
(pre-2.0), 6-21 
REPLC command, 1-5 
Reset startup configuration 
escape sequence, 8-10 
Restore cursor position escape 
sequence, 8-9 

Retrieve the return code of a 
child process, 6-47 
Return country-dependent 

information function call, 
6-32 to 6-34 

Return current setting of verify 
flag function call, 6-48 
Return text of current directory 
function call, 6-43 
Run file prompt, 2-10 

S _ _ _ 

I I (Search) command, 4-35 
ave/Restore cursor position 
escape sequence, 8-9 
Screen Information Block, 7-6 
to 7-9 

Screen manipulation, 8-1 to 8-10 
control codes, 8-1 
escape sequences, 8-2 to 8-10 
Scroll portion of screen 

escape sequence, 8-9 
SEARCH command, 1-6 
Search for the first entry 

function call, 6-18, 6-19 
Search for the next entry 
function call, 6-19 
Sector parameter, 4-7 
Segment, 2-3 to 2-6, 5-2'-(/4IC 
Segment registers 
8086, 5-2, 5-3 
Debugger, 4-3 

Select default screen escape 
sequence, 8-6 

Select disk function call, 6-17 


Semicolon (;) command character, 
3-7 

Send block of characters to the 
screen BIOS function, 7-3 
Send bytes to keyboard BIOS 
function, 7-2 

Send character to screen BIOS 
function, 7-2 

Sequential read function call, 
6-20 

Sequential write function call, 
6-20 

Set/check CONTROL + C state 
function call, 6-30 
Set/Clear screen attributes 
escape sequence, 8-7 
Set date function call, 6-28 
Set disk transfer address 
function call, 6-22 
Set DMA channel BIOS function, 

7-2 

Set event trap BIOS function, 7-1 
Set palette entry attributes 
escape sequence, 8-5 to 
8-6 

Set pointer to configuration 

table BIOS function, 7-1 
Set pointer to system name BIOS 
function, 7-1 

Set relative record function 
call, 6-24 

Set/reset verify flag function 
call, 6-29 

Set time function call, 6-28 
Set vector function call, 6-24 
Shared device memory, 7-10 to 
7-14 , S-ls 

SHELL command, 5-11 / 

SHIFT + CANCEL 

command character, 3-7 
Editor exit, 1-2 
exit address, 6-3 
interrupt, 6-3 

SHIFT + CURSOR commands, 1-4 
SHIFT + ERASE command, 1-5 
SHIFT + GO TO command, 1-7 
SHIFT + INDENT command, 1-7 
SHIFT + NEXT, command, 1-4 
SHIFT + PREV command, 1-4 
SHIFT + SEARCH, 1-6 
Simple characters, 8-11 to 8-18 
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Software/BIOS interface, 7-1 to 

7- 3 

Special characters, 8-19 

Stack pointer, 4-3 

STACK switch, 2-13 

Startup sector, 5-22 to 5-27 s'-* , 

Status driver function, 

8- 52 

STOP command, 1-5 
String parameter, 4-7 
System Configuration Table, 7-6 
System initialization, 5-9 to 
5-12 

System start-up diskette 
contents, 5-8 
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T (Trace) command, 4-36, 4 37 
TAB command (T), 1-6 
Terminate a process function 
call, 6-46, 6-47 

Terminate address interrupt, 6-2 
Terminate but stay resident 
interrupt, 6-5 

Terminate Program function call. 


Three—port MCC board, 7 13, 7-14 
Transporting text files, IBM 
PC to Wang PC, B-3, B-4 
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U (Unas s emb1e) command, 
4-38, 4-39 


Value parameter, 4-8 / 

Visible dead keys, 8-20 


W (Write) command, 4-40, 4-41 
Warm boot BIOS function, 7—3 
Window, 1-3 

Write to a file/device function 
call, 6-37 

WSCII I character set, 8-11 to 
8-17 



XENIX compatible function 
calls, 6-34 to 6-49 
XENIX operating system, 6-7, 


2.0 function calls, 6-29 to 6-49 
8086 Processor, 5-1 

address generation, 5-6, 5-7 
architecture, 5-1, 5-7 
flags, 5-1, 5-3, 5-5 
memory organization, 5—5 to 5 
registers, 5-1, 5-3 
segmentation, 5-2, 5-3 
storage organization, 5-5, 5-6 
& command character, 3-7 
* command character, 3-6 
- command character, 3-6 
+ command character, 3-6 
928 (Local communications card) 
7-12 
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